自作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完成版
↓
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↓
「名前は何でもよいので、末尾が.phpのファイル」
→ PHPファイルをまとめて対象にできます。
📘 科目Bにつなげる:反復
ファイルを1個取り出す
↓
php -lで確認
↓
次のファイルへ
↓
全部終わるまで繰り返す
→
ファイルを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か所で管理
→ 重複を減らし、保守しやすくします。
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インジェクション対策につなげます。
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 → ログインさせない
usernameを検索
↓
passwordを照合
↓
一致する?
↓
YES → sessionにユーザー情報を保存
NO → ログインさせない
STEP 5|認証と認可を確認する
📘 認証と認可は違う
認証(Authentication)
→ 「誰なのか」を確認する。
認可(Authorization)
→ 「その人が何をしてよいか」を判断する。
認証(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
↓
「入っていない」なら
↓
処理を終了
statusは許可された5種類の中にある?
↓
NOT
↓
「入っていない」なら
↓
処理を終了
STEP 7|CSRF対策を確認する
if (empty($_SESSION['csrf_token'])) {
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
📘 CSRFとは?
CSRF = Cross-Site Request Forgery。
ログイン中のユーザーに、 意図しないリクエストを送信させる攻撃への対策を行います。
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('不正なリクエストです。');
}
📘 「??」を読む
csrf_tokenが存在する
→ その値を使う。
存在しない、またはnull
→ 空文字
$_POST['csrf_token'] ?? ''csrf_tokenが存在する
→ その値を使う。
存在しない、またはnull
→ 空文字
''を使う。??はnull合体演算子です。
tokenを作る
↓
sessionに保存
↓
formにも埋め込む
↓
POST
↓
送信されたtokenを検証
↓
正しければ処理を続ける
↓
sessionに保存
↓
formにも埋め込む
↓
POST
↓
送信されたtokenを検証
↓
正しければ処理を続ける
STEP 8|削除はPOSTで実行する
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
// CSRF tokenを確認
// DELETEを実行
}
📘 PHPを読む
→ 削除ページを表示しただけではDELETEせず、 POSTされたときだけ削除処理へ進みます。
$_SERVER = リクエストなどサーバー側の情報を持つスーパーグローバル変数。REQUEST_METHOD = GET / POSTなどのHTTPメソッド。=== 'POST' = POSTと厳密に一致するか確認。→ 削除ページを表示しただけではDELETEせず、 POSTされたときだけ削除処理へ進みます。
📘 HTTPとSQLは別物
→ POSTを受信したPHPが、 MariaDBにDELETE文を実行する流れです。
POST = ブラウザからサーバーへ送るHTTPリクエストの方法。DELETE = ここではDBのデータを削除するSQL命令。→ POSTを受信したPHPが、 MariaDBにDELETE文を実行する流れです。
STEP 9|ログアウト処理を確認する
session_start();
session_unset();
session_destroy();
📘 PHPを読む
→ ログイン時に保存したsession情報を使えない状態にして、 ログアウトします。
session_start() = sessionを開始・再開します。session_unset() = session変数を取り除きます。session_destroy() = サーバー側のsessionデータを破棄します。→ ログイン時に保存したsession情報を使えない状態にして、 ログアウトします。
STEP 10|ブラウザで最終動作確認する
- ログイン:成功
- 記事追加:成功
- 記事編集:成功
- 記事一覧へ戻る導線:成功
- status変更:成功
- 記事削除:成功
- 公開記事詳細の表示:成功
📘 なぜブラウザでも確認する?
構文が正しくても、 条件分岐・SQL・権限・画面遷移などが 意図した動作になるとは限りません。
→ 構文チェックと実際の動作確認は別々に必要です。
php -lで分かるのはPHPの構文エラーです。構文が正しくても、 条件分岐・SQL・権限・画面遷移などが 意図した動作になるとは限りません。
→ 構文チェックと実際の動作確認は別々に必要です。
完成した記事ワークフロー
writerがdraftを作成
↓
in_reviewで公開依頼
↓
editorが確認
↓
needs_revisionで差し戻し
または
publishedで公開
↓
必要に応じてadminがclosedを管理
↓
in_reviewで公開依頼
↓
editorが確認
↓
needs_revisionで差し戻し
または
publishedで公開
↓
必要に応じてadminがclosedを管理
📘 状態遷移として読む
記事は処理によってstatusが変化します。
現在のstatus
+
ユーザーの操作
↓
次のstatus
→ 科目Bで出てくる「状態」と「状態遷移」の考え方にもつながります。
記事は処理によって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を使用するため、
そのため、不特定多数のユーザーが自由にHTMLを投稿できるCMSへ拡張する場合は、 保存型XSSへの追加対策が必要です。
このCMSの記事本文では教材用のHTMLを使用するため、
$article['body']をHTMLとしてそのまま表示しています。そのため、不特定多数のユーザーが自由にHTMLを投稿できるCMSへ拡張する場合は、 保存型XSSへの追加対策が必要です。
📘 htmlspecialchars()ではダメなの?
全文に
→ 今後一般公開型CMSへ発展させるなら、 「許可するHTMLを限定する」などの方法を検討します。
全文に
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
↓
ブラウザ
URL / フォーム / ログイン情報
↓
PHP
条件分岐・認証・認可
↓
PDO
↓
SQL
↓
MariaDB
保存・検索・更新・削除
↓
PHP
↓
HTML
↓
ブラウザ
📘 ここまで読んできたものを整理
HTML = Webページの構造。
CSS = Webページの見た目。
PHP = サーバー側の処理。
SQL = DBへ命令するための言語。
MariaDB = データを管理するDBMS。
PDO = PHPからDBへ接続・操作するための仕組み。
session = ページをまたいでログイン状態などを保持する仕組み。
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開発で書いてきたコードと、 基本情報技術者で学ぶアルゴリズムの考え方はつながっています。
順次処理 → 上から順番に処理する。
条件分岐 → if / elseif。
反復処理 → for。
論理演算 → AND / OR / NOT。
状態遷移 → draft → in_review → publishedなど。
入力 → 処理 → 出力 → CMS全体のデータの流れ。
→ Web開発で書いてきたコードと、 基本情報技術者で学ぶアルゴリズムの考え方はつながっています。