自作CMSを最終監査して完成させる

PHP+MariaDBで作ってきた自作CMSを最終監査し、DB接続、SQL、認証・認可、status制御、CSRF対策、主要機能の動作確認まで行います。これまで実装してきた機能を確認し、自作CMSの第1完成版とします。

今回の目的
  • CMS全体のPHP構文を確認する
  • DB接続方法を整理する
  • SQLの安全性を確認する
  • ログイン・role・statusによる認証・認可を確認する
  • 不正なstatus変更を拒否する
  • CSRF対策を確認する
  • 記事追加・編集・status変更・削除を実際にテストする
  • 自作CMSを第1完成版とする

最終監査の流れ

PHP構文チェック
↓
DB接続確認
↓
SQL確認
↓
認証・認可確認
↓
status制御確認
↓
CSRF対策確認
↓
ブラウザで動作確認
↓
自作CMS 第1完成版

STEP 1|PHPファイルを一括で構文チェックする

for file in /var/www/it-textbook/*.php; do
    php -l "$file"
done
📘 コマンドを読む
for = 同じ処理を繰り返す構文。
file = 今処理しているファイルを入れる変数。
in = 対象となるものを指定します。
*.php = PHPファイルすべて。
do = 繰り返す処理の開始。
php -l = PHPの構文をチェック。
"$file" = 現在のファイル名を参照。
done = 繰り返しの終了。
📘 「*」は何?
* はワイルドカードです。

*.php
↓
「名前は何でもよいので、末尾が.phpのファイル」

→ PHPファイルをまとめて対象にできます。
📘 科目Bにつなげる:反復
ファイルを1個取り出す
↓
php -lで確認
↓
次のファイルへ
↓
全部終わるまで繰り返す

→ for は「反復処理」です。

STEP 2|DB接続をdb.phpにまとめる

require_once __DIR__ . '/db.php';
📘 PHPを読む
require_once = PHPファイルを1回だけ読み込みます。
__DIR__ = 現在のPHPファイルがあるディレクトリ。
. = PHPで文字列を連結する演算子。
'/db.php' = 読み込むファイル名。

→ 現在のディレクトリにある db.phpを読み込みます。
📘 なぜdb.phpにまとめる?
DB接続情報を各PHPファイルに書く
↓
設定変更のたびに複数ファイルを修正

DB接続をdb.phpにまとめる
↓
接続設定を1か所で管理

→ 重複を減らし、保守しやすくします。

STEP 3|SQLの安全性を確認する

$stmt = $pdo->prepare(
    'SELECT id, author_id, title, status
     FROM articles
     WHERE id = ?'
);

$stmt->execute([$id]);
📘 PHP+SQLを読む
$pdo = PHPからDBを操作するPDOオブジェクト。
prepare() = SQLを準備します。
SELECT = データを取得。
FROM articles = articlesテーブルから取得。
WHERE = 条件で絞り込み。
? = 後から値を渡すplaceholder。
execute([$id]) = ?の位置に$idを渡して実行します。
📘 prepared statementとは?
SQLの構造と、外部から渡される値を分けて扱います。

SQLをprepare
↓
値をexecuteで渡す
↓
DBがSQLを実行

→ ユーザー入力をSQL文字列へ直接連結する方法を避け、 SQLインジェクション対策につなげます。

STEP 4|ログインとパスワード確認

if (password_verify($password, $user['password_hash'])) {
    $_SESSION['user_id'] = $user['id'];
    $_SESSION['username'] = $user['username'];
    $_SESSION['role'] = $user['role'];
}
📘 PHPを読む
password_verify() = 入力されたパスワードと保存済みpassword hashを照合します。
if = 条件が成立した場合だけ中の処理を実行。
$_SESSION = 複数ページにまたがって利用するsessionデータ。
user_id = ログインユーザーのID。
username = ユーザー名。
role = admin / editor / writerなどの役割。
📘 処理の流れ
usernameを検索
↓
passwordを照合
↓
一致する?
↓
YES → sessionにユーザー情報を保存
NO → ログインさせない

STEP 5|認証と認可を確認する

📘 認証と認可は違う
認証(Authentication)
→ 「誰なのか」を確認する。

認可(Authorization)
→ 「その人が何をしてよいか」を判断する。
ログイン
↓
user_idを確認
↓
roleを確認
↓
author_idを確認
↓
statusを確認
↓
操作を許可 / 拒否
📘 019までの総復習
role = どんな役割か。
author_id = 誰が書いた記事か。
status = 記事が現在どんな状態か。

→ これらを組み合わせて認可を判断します。

STEP 6|statusの変更ルールを確認する

draft
in_review
needs_revision
published
closed
if (!in_array(
    $status,
    ['draft', 'in_review', 'needs_revision', 'published', 'closed'],
    true
)) {
    exit('不正なstatusです。');
}
📘 PHPを読む
in_array() = 値が配列の中に存在するか確認。
! = NOT。「〜ではない」。
$status = 調べる値。
[...] = 許可するstatusの一覧。
最後のtrue = 型も含めて厳密に比較。
exit() = そこでPHPの処理を終了します。
📘 条件を日本語にする
statusは許可された5種類の中にある?
↓
NOT
↓
「入っていない」なら
↓
処理を終了

STEP 7|CSRF対策を確認する

if (empty($_SESSION['csrf_token'])) {
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
📘 CSRFとは?
CSRF = Cross-Site Request Forgery。

ログイン中のユーザーに、 意図しないリクエストを送信させる攻撃への対策を行います。
📘 PHPを読む
empty() = 値が空かどうか確認。
random_bytes(32) = 暗号学的に安全なランダムな32バイトを生成。
bin2hex() = バイナリデータを16進数の文字列へ変換。
csrf_token = リクエストを確認するためのtoken。
<input
    type="hidden"
    name="csrf_token"
    value="<?= htmlspecialchars(csrf_token()) ?>"
>
📘 HTMLを読む
input = 入力データを送信するHTML要素。
type="hidden" = 画面には表示しない入力欄。
name="csrf_token" = 送信時のデータ名。
value = 実際に送信するtoken。
if (!verify_csrf_token($_POST['csrf_token'] ?? '')) {
    exit('不正なリクエストです。');
}
📘 「??」を読む
$_POST['csrf_token'] ?? ''

csrf_tokenが存在する
→ その値を使う。

存在しない、またはnull
→ 空文字''を使う。

??はnull合体演算子です。
tokenを作る
↓
sessionに保存
↓
formにも埋め込む
↓
POST
↓
送信されたtokenを検証
↓
正しければ処理を続ける

STEP 8|削除はPOSTで実行する

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // CSRF tokenを確認
    // DELETEを実行
}
📘 PHPを読む
$_SERVER = リクエストなどサーバー側の情報を持つスーパーグローバル変数。
REQUEST_METHOD = GET / POSTなどのHTTPメソッド。
=== 'POST' = POSTと厳密に一致するか確認。

→ 削除ページを表示しただけではDELETEせず、 POSTされたときだけ削除処理へ進みます。
📘 HTTPとSQLは別物
POST = ブラウザからサーバーへ送るHTTPリクエストの方法。
DELETE = ここではDBのデータを削除するSQL命令。

→ POSTを受信したPHPが、 MariaDBにDELETE文を実行する流れです。

STEP 9|ログアウト処理を確認する

session_start();

session_unset();

session_destroy();
📘 PHPを読む
session_start() = sessionを開始・再開します。
session_unset() = session変数を取り除きます。
session_destroy() = サーバー側のsessionデータを破棄します。

→ ログイン時に保存したsession情報を使えない状態にして、 ログアウトします。

STEP 10|ブラウザで最終動作確認する

  • ログイン:成功
  • 記事追加:成功
  • 記事編集:成功
  • 記事一覧へ戻る導線:成功
  • status変更:成功
  • 記事削除:成功
  • 公開記事詳細の表示:成功
📘 なぜブラウザでも確認する?
php -lで分かるのはPHPの構文エラーです。

構文が正しくても、 条件分岐・SQL・権限・画面遷移などが 意図した動作になるとは限りません。

→ 構文チェックと実際の動作確認は別々に必要です。

完成した記事ワークフロー

writerがdraftを作成
↓
in_reviewで公開依頼
↓
editorが確認
↓
needs_revisionで差し戻し
または
publishedで公開
↓
必要に応じてadminがclosedを管理
📘 状態遷移として読む
記事は処理によってstatusが変化します。

現在のstatus
+
ユーザーの操作
↓
次のstatus

→ 科目Bで出てくる「状態」と「状態遷移」の考え方にもつながります。

完成したCMSの主な機能

  • ユーザーログイン
  • sessionによるログイン状態管理
  • admin / editor / writerの3role
  • 記事追加・編集・削除
  • 公開記事一覧・詳細表示
  • 5種類のstatus管理
  • writerからeditorへの公開依頼
  • editorによる公開・差し戻し
  • adminによる全体管理
  • prepared statementによるSQL実行
  • CSRF tokenによるPOSTフォーム保護

今後のセキュリティ課題

<?= $article['body'] ?>
📘 本文だけ扱いが違う
このCMSの記事本文では教材用のHTMLを使用するため、 $article['body']をHTMLとしてそのまま表示しています。

そのため、不特定多数のユーザーが自由にHTMLを投稿できるCMSへ拡張する場合は、 保存型XSSへの追加対策が必要です。
📘 htmlspecialchars()ではダメなの?
全文にhtmlspecialchars()を使えばHTMLタグ自体も文字として表示されるため、 教材本文のHTML表示ができなくなります。

→ 今後一般公開型CMSへ発展させるなら、 「許可するHTMLを限定する」などの方法を検討します。

第1完成版

🎉 自作CMS 第1完成版 完成

PHP、MariaDB、PDO、session、認証、認可、role、status、 SQL、CSRF対策まで、自分で実装したCMSとして一通りの機能が完成しました。

さらに「理解する編」では、 コマンドやコードをただ実行するだけではなく、 記号・略語・条件分岐・反復・状態遷移・処理順序まで確認しました。

📘 CMS全体を「入力 → 処理 → 出力」で読む

入力
URL / フォーム / ログイン情報
↓
PHP
条件分岐・認証・認可
↓
PDO
↓
SQL
↓
MariaDB
保存・検索・更新・削除
↓
PHP
↓
HTML
↓
ブラウザ
📘 ここまで読んできたものを整理
HTML = Webページの構造。
CSS = Webページの見た目。
PHP = サーバー側の処理。
SQL = DBへ命令するための言語。
MariaDB = データを管理するDBMS。
PDO = PHPからDBへ接続・操作するための仕組み。
session = ページをまたいでログイン状態などを保持する仕組み。

まとめ

CMSを完成させるには、機能を作るだけではなく、 「誰が操作できるのか」「どのstatusで操作できるのか」 「外部から送られた値をどう確認するのか」まで考える必要があります。

今回の最終監査では、 PHP構文、DB接続、SQL、認証・認可、status制御、CSRF対策、 そして実際のブラウザ操作まで確認しました。

📘 科目Bとして見ると
順次処理 → 上から順番に処理する。
条件分岐 → if / elseif。
反復処理 → for。
論理演算 → AND / OR / NOT。
状態遷移 → draft → in_review → publishedなど。
入力 → 処理 → 出力 → CMS全体のデータの流れ。

→ Web開発で書いてきたコードと、 基本情報技術者で学ぶアルゴリズムの考え方はつながっています。
タグ: PHP / MariaDB / CMS / PDO / SQL / 認証 / 認可 / session / role / status / CSRF / セキュリティ / 条件分岐 / 反復 / 状態遷移