PoiPHP サンプル集

スポンサーリンク

テンプレートの基本($s の使い方)

PoiPHP のテンプレートでは、値を表示する際に $s->html()を使って HTML エスケープを行います。これは XSS 対策として必須です。

$s->html($value)
<?= $s->html($value) ?>
$s->h($value)(短縮形)
<?= $s->h($value) ?>
$s->url($value)

URL パラメータに値を埋め込むときに使用します。

<a href="detail?id=<?= $s->url($id) ?>">詳細</a>
$s->json($value)

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 で書いてください。ルール文字列を配列で渡す方式ではありません。

CSRF(送信側 + 受け側チェック)

トークンは自動生成されますが、チェックは自動では行われません。フォームに _token を入れ、受け側で必ず checkToken() を呼んでください。

送信側(フォーム)
<form method="post">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
<input type="text" name="name">
<button>送信</button>
</form>
受け側(index.php)
<?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 が返ります
}
                        

データベース接続例(SQLite / MySQL)

PoiPHP の DB 設定は PoiPHP/config.phpの databaseセクションで行います。 PDO の DSN を書くだけのシンプルな構成です。

SQLite(最小構成・設定が最も簡単)
'database' => [
    'dsn'  => 'sqlite:' . POI_DIR . '/app.sqlite',
    'user' => null,
    'pass' => null,
],
    

SQLite はファイルを置くだけで動作します。 小規模アプリやローカル開発に最適です。

MySQL / MariaDB
'database' => [
    'dsn'  => 'mysql:host=localhost;dbname=poiphp;charset=utf8mb4',
    'user' => 'root',
    'pass' => 'password',
],
    

MySQL を使う場合は DSN / user / pass を記述します。

接続のタイミング

PoiPHP は「必要な時だけ接続」する設計です。 $c->loadModel()を呼んだ時点で初めて DB に接続します。

動作確認(最小の Model 利用例)
<?php
$User = $c->loadModel("User");
$list = $User->findAll();
$c->set("list", $list);
$c->setTemplateFile("html/user_list.html");
    

モデル(Model)

PoiPHP のモデルは「1 テーブル = 1 クラス」のシンプルな仕組みです。必要な時だけ $c->loadModel() でロードし、findAll / find / findBy / insert / update / delete / query / exec / updateCount が使えます。

モデル定義(models/User.php)

<?php
class UserModel extends Model
{
    public function __construct($db)
    {
        parent::__construct($db, "users");   // 対応するテーブル名
    }
}

loadModel("User") は models/User.php を読み、クラス UserModel(モデル名+Model)を探します。ファイルを作らない場合は汎用 Model が使われ、テーブル名はモデル名の小文字(User → user)になります。テーブル名がそれで合う場合はファイル不要です。

モデルの読み込み(Controller)

$User = $c->loadModel("User");

一覧(findAll)

全件取得します。

$list = $User->findAll();

詳細(find)

主キーで1件取得します。見つからなければ null です。

$user = $User->find($id);

追加(insert)

DB に保存する値は $c->s->postRaw() で受け取ります(post() は表示用にエスケープ済みの値を返すため、保存には向きません)。

$User->insert([
    "name"  => $c->s->postRaw("name"),
    "email" => $c->s->postRaw("email")
]);

更新(update)

主キーを指定して UPDATE します。

$User->update($id, [
    "name"  => $c->s->postRaw("name"),
    "email" => $c->s->postRaw("email")
]);

削除(delete)

主キーを指定して DELETE します。

$User->delete($id);

生 SQL(query)

必要な場合は生 SQL をそのまま実行できます。値はプレースホルダで渡します。

$rows = $User->query("SELECT * FROM users WHERE age > ?", [20]);

テンプレート側の表示例(html/user_list.html)

<h1>User List</h1>
<?php foreach ($list as $u): ?>
<div>
ID: <?= $s->html($u["id"]) ?>
名前: <?= $s->html($u["name"]) ?>
</div>
<?php endforeach; ?>

CRUD(DB操作・実用コード)

PoiPHP の CRUD は「モデル + コントローラ + テンプレート」で構成されます。各ページは独立した PHP ファイル(入口ファイル)として作る例です。

1. モデル(models/User.php)

<?php
class UserModel extends Model
{
    public function __construct($db)
    {
        parent::__construct($db, "users");   // 対応するテーブル名
    }
}

2. 一覧(index.php)

<?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");
}

3. 追加(add.php)

<?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");
}

4. 編集(edit.php)

<?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");
}

5. 削除(delete.php)

削除は 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;
}

6. テンプレート(html/user_list.html)

<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; ?>

7. 追加フォーム(html/user_add.html)

<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>

8. 編集フォーム(html/user_edit.html)

<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 API

JSON を返す場合は $c->json()を返すだけ。

<?php
return $c->json(["status" => "ok"]);