自作CMSにadmin / writerの権限管理を実装する
PHP+MariaDBで作っている自作CMSにadmin / writerの役割を設定し、記事の状態に応じて編集・削除できる範囲を制御します。
🎯 目的
CMSでは、ログインできることと、記事を操作できることは別です。
今回はadminとwriterを分け、記事のstatusに応じて編集・削除できる範囲を制御します。
また、画面上のリンクを隠すだけではなく、URLを直接指定した場合にも権限を確認します。
今回やること
- admin / writerの役割を分ける
- writerは自分の記事だけ扱えるようにする
- 記事のstatusに応じて編集・削除を制御する
- adminだけがstatusを変更できるようにする
- URLを直接指定しても権限をチェックする
↓
roleを確認
↓
admin / writer
↓
記事の所有者・statusを確認
↓
操作できる範囲を決める
STEP 1|adminとwriterを分ける
usersテーブルにはroleを持たせています。
SELECT id, username, role
FROM users;
SELECT = データを取得します。id = ユーザーを識別するIDです。username = ユーザー名です。role = ユーザーの役割です。FROM users = usersテーブルから取得します。→ 「誰なのか」と「どんな役割なのか」をDBから確認できます。
今回はadminとwriterの2種類を使います。
admin
writer
role = 役割・役職という意味です。admin = 管理者
writer = 記事を書くユーザー
roleの値を見て、PHP側で許可する操作を変えます。
認証(Authentication)
→ 「あなたは誰ですか?」を確認する。
認可(Authorization)
→ 「あなたはこの操作をしてよいですか?」を判断する。
014〜016では主に認証を作りました。
017では認証済みユーザーに対して、さらに認可を行います。
STEP 2|記事とユーザーを紐付ける
writerが自分の記事だけを扱えるようにするため、 articlesテーブルにauthor_idを持たせます。
author_id
author = 著者・書いた人。id = 識別番号。→
author_idには、
「この記事を書いたユーザーのID」を保存します。
新しい記事を作成するときは、ログイン中のユーザーIDを保存します。
INSERT INTO articles
(author_id, title, slug, body, status)
VALUES (?, ?, ?, ?, ?)
INSERT INTO articles = articlesテーブルへ新しい行を追加します。author_id = 記事を書いたユーザーのID。title = 記事タイトル。slug = URLなどで使う識別文字列。body = 記事本文。status = 記事の状態。VALUES = 保存する値を指定します。? = あとから値を渡すプレースホルダーです。
author_idにはセッションに保存している
$_SESSION['user_id']を使います。
usersテーブルの
id↓
articlesテーブルの
author_idこうしてユーザーと記事をIDで関連付けます。
→ 「この記事は誰の記事か」をプログラムが判断できるようになります。
STEP 3|writerは自分の記事だけを見る
記事一覧では、adminとwriterで取得する記事を分けます。
if ($role === 'admin') {
$stmt = $pdo->query(
'SELECT id, title, slug, status, created_at
FROM articles
ORDER BY id DESC'
);
} else {
$stmt = $pdo->prepare(
'SELECT id, title, slug, status, created_at
FROM articles
WHERE author_id = ?
ORDER BY id DESC'
);
$stmt->execute([$userId]);
}
if = 条件が成立したときの処理です。$role = ログインユーザーの役割です。=== = 値と型が同じかを厳密に比較します。'admin' = 比較する文字列です。else = ifの条件が成立しなかった場合の処理です。→ roleがadminかどうかでSQLそのものを切り替えています。
FROM articlesのあとに
author_idによる絞り込みがありません。→ 全記事を取得します。
ORDER BY id DESC→ idを降順(大きいものから小さいもの)に並べます。
WHERE author_id = ?→ author_idが指定されたユーザーIDと一致する記事だけ取得します。
$stmt->execute([$userId])→
?へログインユーザーのIDを渡してSQLを実行します。→ writerには「自分の記事だけ」をDBから取得しています。
roleはadminか?
↓
YES → 全記事を取得
NO → author_idで絞り込み
→ 同じ「記事一覧を表示する」という処理でも、 条件によって実行するSQLが変わります。
writer_testでログインし、自分が作成した記事だけ表示されることを確認しました。
STEP 4|記事statusで操作を制御する
記事には5つのstatusを用意しています。
draft
in_review
needs_revision
published
closed
draft = 下書きin_review = 公開依頼・確認中needs_revision = 差し戻し・修正が必要published = 公開済みclosed = 非公開→ statusは「この記事が今どんな状態か」を表すデータです。
writerの操作範囲はstatusによって変わります。
draft
→ 編集・削除
in_review
→ 編集・削除できない
needs_revision
→ 編集できる・削除できない
published
→ 編集・削除できない
closed
→ 編集・削除できない
writerだから常に編集できる、という仕組みではありません。
誰か → role
誰の記事か → author_id
今どんな状態か → status
この複数の条件を組み合わせて、 最終的に操作を許可するか決めます。
adminは全statusの記事を管理できます。
STEP 5|URLを直接指定しても権限を確認する
画面上のボタンを隠すだけでは、権限管理としては不十分です。
そこで、各処理ページでもセッションやrole、記事の所有者、 statusを確認します。
例えばstatus変更ページはadminだけが利用できます。
if (($_SESSION['role'] ?? '') !== 'admin') {
exit('この記事のstatusは変更できません。');
}
$_SESSION['role'] = ログインユーザーのroleです。?? = Null合体演算子です。左側の値が存在しない、またはNULLなら右側を使います。'' = 空文字です。!== = 値または型が同じではないことを厳密に比較します。'admin' = 管理者を表すroleです。→ roleがadminではない場合に処理を拒否します。
$_SESSION['role'] ?? ''roleが存在する
→ roleの値を使う
roleが存在しない、またはNULL
→ 空文字
''を使うその結果を
'admin'と比較しています。
条件に当てはまった場合、
exit()でPHPの処理を終了します。→ 画面上でリンクを消すだけではなく、 サーバー側の処理そのものを止めています。
writerがURLを直接指定しても、status変更処理は許可されません。
「ボタンを表示しない」と「処理そのものを拒否する」は別です。
権限を持たないユーザーからの操作は、 PHP側でも拒否します。
STEP 6|管理画面もadmin専用にする
管理画面も、ログインしているだけではアクセスできないようにしました。
if (($_SESSION['role'] ?? '') !== 'admin') {
exit('管理画面にはアクセスできません。');
}
016では主に
user_idを確認して、
「ログインしているか」を判定しました。017ではさらに
roleを確認して、
「管理画面を利用する権限があるか」を判定します。user_id → 認証状態の確認
role → 認可の判断
→ ログイン済みでも、権限がなければ処理を拒否できます。
writerが管理画面のURLを直接開いても拒否されます。
📘 3つの条件を整理する
role
→ このユーザーはadminかwriterか?
author_id
→ この記事は誰が書いたものか?
status
→ この記事は現在どんな状態か?
→ 「ユーザーの役割」「記事の所有者」「記事の状態」を組み合わせて、 操作を許可するか拒否するか判断します。
📘 科目Bにつなげる:複数条件による判定
ログインしているか?
↓
writer本人の記事か?
↓
編集できるstatusか?
↓
条件を満たす → 編集を許可
条件を満たさない → 拒否
→ 1つの条件だけではなく、 複数の条件を順番に確認して結果を決めています。
今回の仕組み
↓
login.php
↓
session
↓
roleを確認
↓
author_idを確認
↓
article statusを確認
↓
操作を許可 / 拒否
今回は、認証したユーザーの情報をセッションに保存し、 role・author_id・statusを使って操作できる範囲を決めました。
📘 016と017のつながり
セッションのuser_idを確認し、 ログインしているかどうかを判定しました。
017
ログイン後さらにrole・author_id・statusを確認し、 そのユーザーに操作を許可するか判断します。
→ 016は主に認証状態の確認、 017は認可へ進んだ回です。
📘 処理の流れを読む
↓
条件①:roleは何か?
↓
条件②:記事のauthor_idは誰か?
↓
条件③:記事のstatusは何か?
↓
処理:条件に応じて操作を許可または拒否
↓
出力:利用できる記事・操作だけを表示/実行
→ 「入力 → 複数条件の判定 → 処理 → 出力」という流れです。
📝 今回の忘備録
ログインしていることと、権限があることは別。
admin / writerというroleだけでなく、 記事のauthor_idとstatusも使って操作できる範囲を判断する。
また、画面上でリンクを隠すだけではなく、 PHP側でも権限チェックを行う。
URLを直接指定されることも考えて、 各処理ページでアクセス権を確認する。
この先やること
- RLSに相当する認可処理をさらに整理する
- 記事statusの変更フローを整理する
- 管理者とwriterの操作画面をさらに整理する