PoiPHP の「最小・明快・必要最小限」という思想を活かして、 実際に動く簡易掲示板(BBS)を作る流れを紹介します。
SQLite / MySQL どちらでも動きます。
CREATE TABLE posts (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT,
body TEXT,
created_at TEXT
);
1 テーブル = 1 クラス。必要なのはこれだけです。
<?php
class PostModel extends Model
{
public function __construct($db)
{
parent::__construct($db, "posts");
}
}
loadModel("Post") は models/Post.php を読み、クラス PostModel(モデル名+Model)を探します。
※ファイルを作らない場合は汎用 Model が使われ、テーブル名はモデル名の小文字(Post → post)になります。このチュートリアルのテーブルは posts なので、ファイルを作って対応付けます。
このチュートリアルでは SQLite を使用します。
PoiPHP/config.php の database セクションを以下のように設定してください。
'database' => [
'dsn' => 'sqlite:' . POI_DIR . '/app.sqlite',
'user' => null,
'pass' => null,
],
SQLite はファイルを置くだけで動作するため、最も簡単に始められます。 MySQL を使いたい場合は DSN を書き換えてください。
ついでに、レイアウトも有効にしておきます(手順5で使います)。同じ config.php の layout を以下のように設定してください。
'layout' => 'html/layout.html',
投稿処理と一覧表示を 1 ファイルで完結できます。DB に保存する値は $c->s->postRaw() で受け取ります(表示の時にテンプレートでエスケープするためです)。
<?php
require_once __DIR__ . '/PoiPHP/poiphp.php';
function action(&$c)
{
$Post = $c->loadModel("Post");
// 投稿処理
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
// CSRF チェック(自動では行われないので、最初に必ず自分で確認します)
if (!$c->session->checkToken($c->s->postRaw('_token'))) {
http_response_code(403);
exit('CSRF token mismatch');
}
$Post->insert([
"name" => $c->s->postRaw("name"),
"body" => $c->s->postRaw("body"),
"created_at" => date("Y-m-d H:i:s")
]);
header('Location: index.php');
exit;
}
// 一覧
$list = $Post->query("SELECT * FROM posts ORDER BY id DESC");
$c->set("title", "簡易掲示板");
$c->set("list", $list);
$c->setTemplateFile("html/bbs.html");
}
手順3で config の layout を設定したので、テンプレートはすべて
html/layout.html を通して表示されます。テンプレート側は「中身だけ」書けばよく、
ヘッダーやフッターは layout にまとめて管理します。
<!DOCTYPE html> <html lang="ja"> <head> <meta charset="UTF-8"> <title><?= $s->html($title ?? "PoiPHP") ?></title> </head> <body> <div class="container mt-4"> <?= $_poi_content ?> <!-- ← テンプレートの内容がここに入る --> </div> </body> </html>
$_poi_content は PoiPHP が自動で用意する変数で、テンプレートの内容がそのまま入ります。
開発者が定義する必要はありません。
フォームと一覧を表示するだけのシンプルなテンプレートです。 ヘッダーやフッターは layout.html に任せます。
<h1>簡易掲示板</h1>
<form method="post">
<input type="hidden" name="_token" value="<?= $s->html($c->csrf) ?>">
名前:<br>
<input type="text" name="name"><br><br>
本文:<br>
<textarea name="body" rows="4" cols="40"></textarea><br><br>
<button>投稿</button>
</form>
<hr>
<?php foreach ($list as $p): ?>
<div style="margin-bottom:20px;">
<strong><?= $s->html($p["name"]) ?></strong>
(<?= $s->html($p["created_at"]) ?>)<br>
<?= nl2br($s->html($p["body"])) ?>
</div>
<?php endforeach; ?>
わずか数ファイルで、実際に動く掲示板が作れます。
コントローラ・モデル・テンプレート・レイアウトが最小構成でまとまり、 PoiPHP の「余計なものはポイ」という思想を体験できるサンプルです。