スポンサーリンク
PoiPHP のテンプレートでは、値を表示する際に
$s->html()を使って HTML エスケープを行います。これは XSS 対策として必須です。
<?= $s->html($value) ?>
<?= $s->h($value) ?>
URL パラメータに値を埋め込むときに使用します。
<a href="detail?id=<?= $s->url($id) ?>">詳細</a>
JavaScript に PHP の値を安全に埋め込むときに使用します。
<script>
const data = <?= $s->json($array) ?>;
</script>
PoiPHP のセッションは
$c->sessionで扱います。 set / get / delete の 3 種類だけなので非常にシンプルです。
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
// セッションに値を保存
$c->session->set("name", "bee");
// セッションから値を取得
$name = $c->session->get("name");
// セッションの値を削除
$c->session->delete("name");
// テンプレートへ渡す
$c->set("name", $name);
$c->setTemplateFile("html/session.html");
}
PoiPHP のバリデーションは $c->v(Validate)のメソッドで行います。必須・文字数・メール形式など、必要最小限のメソッドで構成されています。
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
$errors = [];
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
$s = $c->s;
$v = $c->v;
$name = trim((string)$s->postRaw('name'));
$email = trim((string)$s->postRaw('email'));
$age = $s->postRaw('age');
$password = (string)$s->postRaw('password');
$password2 = (string)$s->postRaw('password2');
// 各メソッドは「成功で空文字、失敗でメッセージ」を返すので、array_filter でエラーだけ集められます
$errors = array_filter([
'name' => $v->notempty($name, '名前は必須です') ?: $v->len($name, 20, 3, '名前は3〜20文字で入力してください'),
'email' => $v->notempty($email, 'メールは必須です') ?: $v->email($email, 'メールの形式が正しくありません'),
'age' => $v->number($age, '年齢は数値で入力してください'),
'password' => $v->len($password, 50, 8, 'パスワードは8〜50文字で入力してください'),
'password2' => $v->password($password, $password2, 'パスワードが一致しません'),
]);
// 範囲チェックのような専用メソッドがない条件は、そのまま PHP で書きます
if (is_numeric($age) && ($age < 18 || $age > 120)) {
$errors['age'] = '年齢は18〜120で入力してください';
}
if ($errors) {
$c->set('errors', $errors);
} else {
$c->set('ok', true);
}
}
$c->setTemplateFile('html/validation.html');
}
テンプレート側では、渡された $errors を表示するだけです。
<?php if (!empty($errors)): ?>
<ul>
<?php foreach ($errors as $e): ?>
<li><?= $s->html($e) ?></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
Validate($c->v / テンプレートでは $v ではなくコントローラ側で使用)のメソッド一覧です。どのメソッドも「成功で空文字、失敗でメッセージ(省略時は false)」を返します。
notempty($data, $msg) 空でないこと(空白のみも不可) len($data, $max, $min, $msg) 文字数チェック(マルチバイト対応。例:len($name, 20, 3, '...')) number($data, $msg) 数値であること eisu($data, $msg) 英数字のみ eisu_hu($data, $msg) 英数字とハイフン、アンダースコアのみ email($data, $msg) メール形式であること password($a, $b, $msg) 2つの値が一致すること(パスワード確認用)
数値の範囲(min / max)など、専用メソッドがない条件は通常の PHP で書いてください。ルール文字列を配列で渡す方式ではありません。
トークンは自動生成されますが、チェックは自動では行われません。フォームに _token を入れ、受け側で必ず checkToken() を呼んでください。
<form method="post">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
<input type="text" name="name">
<button>送信</button>
</form>
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
// POST の最初に必ず書く(チェックは自動では行われません)
if (!$c->session->checkToken($c->s->postRaw('_token'))) {
http_response_code(403);
exit('CSRF token mismatch');
}
// 通常の処理
$name = $c->s->postRaw('name');
$c->set('name', $name);
}
$c->setTemplateFile('html/form.html');
}
ファイルアップロードは $c->upload->save() を呼ぶだけです。
ディレクトリがなければ自動で作成し、ファイル名は衝突しないようリネームして保存されます。
// 第一引数:inputのname属性、第二引数:保存先ディレクトリ
$path = $c->upload->save("photo", "uploads");
if ($path) {
// 成功:保存されたパス(例:uploads/9f2ab1c4d5e6f708192a3b4c5d6e7f80_1730000000.jpg)が返ります
// ※ファイル名は「ランダムな文字列_時刻.拡張子」にリネームされます
} elseif ($path === false) {
// 拒否:拡張子が許可されていない、サイズ上限を超えた等
} else {
// 未選択・アップロードエラー:null が返ります
}
PoiPHP の DB 設定は
PoiPHP/config.phpの
databaseセクションで行います。 PDO の DSN を書くだけのシンプルな構成です。
'database' => [
'dsn' => 'sqlite:' . POI_DIR . '/app.sqlite',
'user' => null,
'pass' => null,
],
SQLite はファイルを置くだけで動作します。 小規模アプリやローカル開発に最適です。
'database' => [
'dsn' => 'mysql:host=localhost;dbname=poiphp;charset=utf8mb4',
'user' => 'root',
'pass' => 'password',
],
MySQL を使う場合は DSN / user / pass を記述します。
PoiPHP は「必要な時だけ接続」する設計です。
$c->loadModel()を呼んだ時点で初めて DB に接続します。
<?php
$User = $c->loadModel("User");
$list = $User->findAll();
$c->set("list", $list);
$c->setTemplateFile("html/user_list.html");
PoiPHP のモデルは「1 テーブル = 1 クラス」のシンプルな仕組みです。必要な時だけ $c->loadModel() でロードし、findAll / find / findBy / insert / update / delete / query / exec / updateCount が使えます。
<?php
class UserModel extends Model
{
public function __construct($db)
{
parent::__construct($db, "users"); // 対応するテーブル名
}
}
loadModel("User") は models/User.php を読み、クラス UserModel(モデル名+Model)を探します。ファイルを作らない場合は汎用 Model が使われ、テーブル名はモデル名の小文字(User → user)になります。テーブル名がそれで合う場合はファイル不要です。
$User = $c->loadModel("User");
全件取得します。
$list = $User->findAll();
主キーで1件取得します。見つからなければ null です。
$user = $User->find($id);
DB に保存する値は $c->s->postRaw() で受け取ります(post() は表示用にエスケープ済みの値を返すため、保存には向きません)。
$User->insert([
"name" => $c->s->postRaw("name"),
"email" => $c->s->postRaw("email")
]);
主キーを指定して UPDATE します。
$User->update($id, [
"name" => $c->s->postRaw("name"),
"email" => $c->s->postRaw("email")
]);
主キーを指定して DELETE します。
$User->delete($id);
必要な場合は生 SQL をそのまま実行できます。値はプレースホルダで渡します。
$rows = $User->query("SELECT * FROM users WHERE age > ?", [20]);
<h1>User List</h1>
<?php foreach ($list as $u): ?>
<div>
ID: <?= $s->html($u["id"]) ?>
名前: <?= $s->html($u["name"]) ?>
</div>
<?php endforeach; ?>
PoiPHP の CRUD は「モデル + コントローラ + テンプレート」で構成されます。各ページは独立した PHP ファイル(入口ファイル)として作る例です。
<?php
class UserModel extends Model
{
public function __construct($db)
{
parent::__construct($db, "users"); // 対応するテーブル名
}
}
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
$User = $c->loadModel("User");
$list = $User->findAll();
$c->set("list", $list);
$c->setTemplateFile("html/user_list.html");
}
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
if (!$c->session->checkToken($c->s->postRaw('_token'))) {
http_response_code(403);
exit('CSRF token mismatch');
}
$User = $c->loadModel("User");
$User->insert([
"name" => $c->s->postRaw("name"),
"email" => $c->s->postRaw("email")
]);
header('Location: index.php');
exit;
}
$c->setTemplateFile("html/user_add.html");
}
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
$User = $c->loadModel("User");
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
if (!$c->session->checkToken($c->s->postRaw('_token'))) {
http_response_code(403);
exit('CSRF token mismatch');
}
$id = (int)($c->s->postRaw('id') ?? 0);
$User->update($id, [
"name" => $c->s->postRaw("name"),
"email" => $c->s->postRaw("email")
]);
header('Location: index.php');
exit;
}
$id = (int)($c->s->getRaw('id') ?? 0);
$user = $User->find($id);
$c->set("user", $user);
$c->setTemplateFile("html/user_edit.html");
}
削除は GET では行わず、CSRF トークン付きの POST で受け付けます。
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
// 削除は POST のみ受け付けます
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') !== 'POST') {
http_response_code(405);
exit('Method Not Allowed');
}
if (!$c->session->checkToken($c->s->postRaw('_token'))) {
http_response_code(403);
exit('CSRF token mismatch');
}
$User = $c->loadModel("User");
$User->delete((int)($c->s->postRaw('id') ?? 0));
header('Location: index.php');
exit;
}
<h1>User List</h1>
<a href="add.php">新規追加</a>
<?php foreach ($list as $u): ?>
<div>
<?= $s->html($u["id"]) ?> : <?= $s->html($u["name"]) ?>
<a href="edit.php?id=<?= $s->url($u["id"]) ?>">編集</a>
<form method="post" action="delete.php" style="display:inline">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
<input type="hidden" name="id" value="<?= $s->html($u["id"]) ?>">
<button>削除</button>
</form>
</div>
<?php endforeach; ?>
<h1>User Add</h1>
<form method="post">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
名前:<input type="text" name="name"><br>
メール:<input type="text" name="email"><br>
<button>登録</button>
</form>
<h1>User Edit</h1>
<form method="post">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
<input type="hidden" name="id" value="<?= $s->html($user["id"]) ?>">
名前:<input type="text" name="name" value="<?= $s->html($user["name"]) ?>"><br>
メール:<input type="text" name="email" value="<?= $s->html($user["email"]) ?>"><br>
<button>更新</button>
</form>
JSON を返す場合は
$c->json()を返すだけ。
<?php
return $c->json(["status" => "ok"]);