PoiPHP で簡易掲示板を作ってみる

< TOP に戻る

概要

PoiPHP の「最小・明快・必要最小限」という思想を活かして、 実際に動く簡易掲示板(BBS)を作る流れを紹介します。

1. テーブルを作る

SQLite / MySQL どちらでも動きます。

CREATE TABLE posts (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT,
    body TEXT,
    created_at TEXT
);
        

2. モデルを作る(models/Post.php)

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 なので、ファイルを作って対応付けます。

3. config.php の設定

このチュートリアルでは 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',

4. コントローラ(index.php)

投稿処理と一覧表示を 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");
}

5. レイアウト(html/layout.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 が自動で用意する変数で、テンプレートの内容がそのまま入ります。 開発者が定義する必要はありません。

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

フォームと一覧を表示するだけのシンプルなテンプレートです。 ヘッダーやフッターは 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 の「余計なものはポイ」という思想を体験できるサンプルです。