自作CMSのadmin / editor / writer権限を完成させる
PHP+MariaDBで作っている自作CMSに、admin / editor / writerの3つのroleによる操作権限を実装し、記事のstatusに応じた編集・status変更・削除の制御を完成させます。
🎯 目的
017ではadmin / writerの認可を学び、 018ではeditorと担当writerの関係を追加しました。
今回はadmin / editor / writerの3つのroleについて、 編集・status変更・削除の権限を整理し、 CMSの操作権限を完成させます。
roleだけでなく、記事のauthor_idとstatusも確認して、 操作を許可するか拒否するか判断します。
↓
roleを確認
↓
author_idを確認
↓
statusを確認
↓
編集 / status変更 / 削除を許可・拒否
STEP 1|3つのroleの操作範囲を整理する
admin
editor
writer
admin = CMS全体を管理する管理者。editor = writerの記事を確認する編集者。writer = 記事を書くユーザー。→ ログインできるかどうかだけではなく、 roleによって実行できる処理を変えます。
writerは自分の記事を作成し、公開依頼を行います。
editorは自分の記事に加えて担当writerの記事を確認し、 公開または差し戻しを行います。
adminはすべての記事を管理できます。
誰なのか →
role誰の記事か →
author_id今どんな状態か →
status→ この3種類の情報を組み合わせて権限を判断します。
STEP 2|記事一覧の操作リンクを出し分ける
$canEdit = false;
$canChangeStatus = false;
$canDelete = false;
$canEdit = 編集してよいか。$canChangeStatus = statusを変更してよいか。$canDelete = 削除してよいか。false = 偽。ここでは「許可しない」。true = 真。ここでは「許可する」。→ 最初はすべてfalseにしておき、 条件を満たした操作だけtrueにします。
最初はfalse
↓
roleを確認
↓
author_idを確認
↓
statusを確認
↓
条件を満たす → true
<?php if ($canEdit): ?>
<a href="article-edit.php?id=...">編集</a>
<?php endif; ?>
<?php if ($canChangeStatus): ?>
<a href="article-status.php?id=...">status変更</a>
<?php endif; ?>
<?php if ($canDelete): ?>
<a href="article-delete.php?id=...">削除</a>
<?php endif; ?>
if ($canEdit) = 編集可能か確認します。<a href="..."> = HTMLのリンクです。endif; = ifの範囲を終了します。→ PHPで条件を判定して、 必要なHTMLだけを出力します。
STEP 3|writerの操作をstatusで制限する
draft
→ 編集 / 公開依頼 / 削除
in_review
→ 操作不可
needs_revision
→ 編集 / 再度公開依頼
published
→ 操作不可
closed
→ 操作不可
draft = 下書き。in_review = 公開依頼・確認中。needs_revision = 差し戻し・修正が必要。published = 公開済み。closed = 公開終了後などに使う管理状態。→ 同じwriterの記事でも、 statusによって実行できる処理が変わります。
STEP 4|editorは担当writerの記事を管理する
WHERE a.author_id = ?
OR u.editor_id = ?
WHERE = データを絞り込む条件。a.author_id = ? = 自分の記事か確認。OR = どちらか一方が成立すればよい。u.editor_id = ? = 自分が担当するwriterか確認。→ editorには、 「自分の記事」または「担当writerの記事」を表示します。
in_review
├─ published
└─ needs_revision
editorが記事を確認
↓
公開してよい?
↓
YES → published
NO → needs_revision
STEP 5|closedをadmin専用の状態にする
closed
admin
→ 編集 / status変更 / 削除 / 再公開
editor
→ 操作不可
writer
→ 操作不可
このCMSでは
closedを
adminだけが操作できる管理状態として設計しています。→ statusも権限判定の材料になります。
STEP 6|削除できる記事を制限する
if ($isAdmin) {
$canDelete = true;
} elseif (
($role === 'writer' || $role === 'editor')
&& (int)$article['author_id'] === $userId
&& $article['status'] === 'draft'
) {
$canDelete = true;
}
if = 最初の条件を確認します。elseif = ifが成立しなかった場合に別の条件を確認します。|| = OR。「または」。&& = AND。「かつ」。(int) = 値を整数として扱う型変換。=== = 値と型の両方を厳密に比較します。
adminである
→ 削除OK
または、
writerまたはeditorである
AND
自分の記事である
AND
draftである
↓
すべて成立 → 削除OK
||(OR)→ 条件のどちらかが成立すればtrue。
&&(AND)→ 条件がすべて成立したときtrue。
→ プログラムの複雑な条件も、 一つずつ日本語にすると読みやすくなります。
STEP 7|URLを直接指定しても権限を確認する
↓
操作リンクを表示するか判断
各処理ページ
↓
もう一度権限を判断
↓
条件を満たさない
↓
処理を終了
一覧画面でリンクを消す
→ 画面上の操作を制限する。
article-edit.phpなどでも確認する
→ サーバー側で実際の処理を拒否する。
→ リンクが見えないこと自体は、 サーバー側の認可の代わりにはなりません。
STEP 8|status変更画面を仕上げる
<option value="published"
<?= $article['status'] === 'published'
? 'selected'
: '' ?>>
published(公開)
</option>
$article['status'] === 'published'→ 現在publishedか確認。
?→ 条件がtrueならこちら。
:→ 条件がfalseならこちら。
'selected'→ HTMLの選択肢を選択済みにします。
''→ 空文字。何も追加しません。
現在のstatusはpublished?
↓
YES → selected
NO → 何も付けない
→ 三項演算子は、 短い条件分岐を1つの式で書く方法です。
📘 statusを「状態遷移」として読む
draft
↓ 公開依頼
in_review
↓
published
または
in_review
↓ 差し戻し
needs_revision
↓ 修正・再申請
in_review
↓
published
→ 「現在の状態」と「次に移動できる状態」を 管理していると考えると分かりやすくなります。
完成した権限管理
writer
・自分の記事を作成
・自分のdraft / needs_revisionを編集
・公開依頼
・自分のdraftを削除
editor
・自分の記事を作成
・自分と担当writerの記事を確認
・担当writerの記事を公開 / 差し戻し
・自分のdraftを削除
・closedは操作不可
admin
・すべての記事を管理
・編集
・status変更
・削除
・closedから再公開
📘 017 → 018 → 019
admin / writerで認可の基本を作る。
↓
018
editorを追加して、 担当writerの記事を確認する仕組みを作る。
↓
019
role・author_id・statusを組み合わせて、 admin / editor / writerの権限管理を完成させる。
📘 処理の流れを読む
↓
条件①:roleは何か?
↓
条件②:author_idは誰か?
↓
条件③:statusは何か?
↓
処理:編集・status変更・削除の可否を決定
↓
出力:操作を許可または拒否
→ 「入力 → 条件判定 → 処理 → 出力」という流れです。
📝 今回の忘備録
権限管理はroleだけで決めず、 author_idとstatusも組み合わせる。
ANDとORを使って、 複数の条件を組み合わせる。
操作リンクを非表示にするだけでなく、 各処理ページでも権限を確認する。
statusは記事の現在の状態だけでなく、 次に許可する操作を判断する材料にもなる。
この先やること
- CMS全体のセキュリティを最終確認する
- 認証・認可・SQL・HTML出力を確認する
- 主要機能を通して動作確認する
- 自作CMSを完成させる