自作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
📘 3つのrole
admin = CMS全体を管理する管理者。
editor = writerの記事を確認する編集者。
writer = 記事を書くユーザー。

→ ログインできるかどうかだけではなく、 roleによって実行できる処理を変えます。

writerは自分の記事を作成し、公開依頼を行います。

editorは自分の記事に加えて担当writerの記事を確認し、 公開または差し戻しを行います。

adminはすべての記事を管理できます。

📘 roleだけでは決まらない
誰なのか → role
誰の記事か → author_id
今どんな状態か → status

→ この3種類の情報を組み合わせて権限を判断します。

STEP 2|記事一覧の操作リンクを出し分ける

$canEdit = false;
$canChangeStatus = false;
$canDelete = false;
📘 PHPを読む
$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; ?>
📘 PHPとHTMLを読む
if ($canEdit) = 編集可能か確認します。
<a href="..."> = HTMLのリンクです。
endif; = ifの範囲を終了します。

→ PHPで条件を判定して、 必要なHTMLだけを出力します。

STEP 3|writerの操作をstatusで制限する

draft
→ 編集 / 公開依頼 / 削除

in_review
→ 操作不可

needs_revision
→ 編集 / 再度公開依頼

published
→ 操作不可

closed
→ 操作不可
📘 statusを読む
draft = 下書き。
in_review = 公開依頼・確認中。
needs_revision = 差し戻し・修正が必要。
published = 公開済み。
closed = 公開終了後などに使う管理状態。

→ 同じwriterの記事でも、 statusによって実行できる処理が変わります。

STEP 4|editorは担当writerの記事を管理する

WHERE a.author_id = ?
   OR u.editor_id = ?
📘 SQLを読む
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
→ 操作不可
📘 closedを読む
この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
📘 科目Bにつなげる:AND / OR
||(OR)
→ 条件のどちらかが成立すればtrue。

&&(AND)
→ 条件がすべて成立したときtrue。

→ プログラムの複雑な条件も、 一つずつ日本語にすると読みやすくなります。

STEP 7|URLを直接指定しても権限を確認する

一覧画面
↓
操作リンクを表示するか判断

各処理ページ
↓
もう一度権限を判断
↓
条件を満たさない
↓
処理を終了
📘 なぜ2回確認する?
一覧画面でリンクを消す
→ 画面上の操作を制限する。

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を「状態遷移」として読む

statusは単なる5種類の文字列ではありません。

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

017
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は記事の現在の状態だけでなく、 次に許可する操作を判断する材料にもなる。

この先やること

タグ: PHP / MariaDB / SQL / CMS / Authentication / Authorization / admin / editor / writer / role / author_id / status / AND / OR