自作CMSにadmin / writerの権限管理を実装する

PHP+MariaDBで作っている自作CMSにadmin / writerの役割を設定し、記事の状態に応じて編集・削除できる範囲を制御します。

🎯 目的

CMSでは、ログインできることと、記事を操作できることは別です。

今回はadminとwriterを分け、記事のstatusに応じて編集・削除できる範囲を制御します。

また、画面上のリンクを隠すだけではなく、URLを直接指定した場合にも権限を確認します。

今回やること

  1. admin / writerの役割を分ける
  2. writerは自分の記事だけ扱えるようにする
  3. 記事のstatusに応じて編集・削除を制御する
  4. adminだけがstatusを変更できるようにする
  5. URLを直接指定しても権限をチェックする
ログイン
↓
roleを確認
↓
admin / writer
↓
記事の所有者・statusを確認
↓
操作できる範囲を決める

STEP 1|adminとwriterを分ける

usersテーブルにはroleを持たせています。

SELECT id, username, role
FROM users;
📘 SQLを読む
SELECT = データを取得します。
id = ユーザーを識別するIDです。
username = ユーザー名です。
role = ユーザーの役割です。
FROM users = usersテーブルから取得します。

→ 「誰なのか」と「どんな役割なのか」をDBから確認できます。

今回はadminとwriterの2種類を使います。

admin
writer
📘 roleとは
role = 役割・役職という意味です。

admin = 管理者
writer = 記事を書くユーザー

roleの値を見て、PHP側で許可する操作を変えます。
📘 認証と認可
認証(Authentication)
→ 「あなたは誰ですか?」を確認する。

認可(Authorization)
→ 「あなたはこの操作をしてよいですか?」を判断する。

014〜016では主に認証を作りました。
017では認証済みユーザーに対して、さらに認可を行います。

STEP 2|記事とユーザーを紐付ける

writerが自分の記事だけを扱えるようにするため、 articlesテーブルにauthor_idを持たせます。

author_id
📘 author_idとは
author = 著者・書いた人。
id = 識別番号。

→ author_idには、 「この記事を書いたユーザーのID」を保存します。

新しい記事を作成するときは、ログイン中のユーザーIDを保存します。

INSERT INTO articles
    (author_id, title, slug, body, status)
VALUES (?, ?, ?, ?, ?)
📘 SQLを読む
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]);
}
📘 PHPの条件分岐を読む
if = 条件が成立したときの処理です。
$role = ログインユーザーの役割です。
=== = 値と型が同じかを厳密に比較します。
'admin' = 比較する文字列です。
else = ifの条件が成立しなかった場合の処理です。

→ roleがadminかどうかでSQLそのものを切り替えています。
📘 admin側のSQL
FROM articlesのあとに author_idによる絞り込みがありません。

→ 全記事を取得します。

ORDER BY id DESC
→ idを降順(大きいものから小さいもの)に並べます。
📘 writer側のSQL
WHERE author_id = ?
→ author_idが指定されたユーザーIDと一致する記事だけ取得します。

$stmt->execute([$userId])
→ ?へログインユーザーのIDを渡してSQLを実行します。

→ writerには「自分の記事だけ」をDBから取得しています。
📘 科目Bにつなげる:分岐
roleはadminか?
↓
YES → 全記事を取得
NO → author_idで絞り込み

→ 同じ「記事一覧を表示する」という処理でも、 条件によって実行するSQLが変わります。
確認
writer_testでログインし、自分が作成した記事だけ表示されることを確認しました。

STEP 4|記事statusで操作を制御する

記事には5つのstatusを用意しています。

draft
in_review
needs_revision
published
closed
📘 statusを読む
draft = 下書き
in_review = 公開依頼・確認中
needs_revision = 差し戻し・修正が必要
published = 公開済み
closed = 非公開

→ statusは「この記事が今どんな状態か」を表すデータです。

writerの操作範囲はstatusによって変わります。

draft
→ 編集・削除

in_review
→ 編集・削除できない

needs_revision
→ 編集できる・削除できない

published
→ 編集・削除できない

closed
→ 編集・削除できない
📘 roleだけでは決まらない
writerだから常に編集できる、という仕組みではありません。

誰か → role
誰の記事か → author_id
今どんな状態か → status

この複数の条件を組み合わせて、 最終的に操作を許可するか決めます。

adminは全statusの記事を管理できます。

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

画面上のボタンを隠すだけでは、権限管理としては不十分です。

そこで、各処理ページでもセッションやrole、記事の所有者、 statusを確認します。

例えばstatus変更ページはadminだけが利用できます。

if (($_SESSION['role'] ?? '') !== 'admin') {
    exit('この記事のstatusは変更できません。');
}
📘 PHPを読む
$_SESSION['role'] = ログインユーザーのroleです。
?? = Null合体演算子です。左側の値が存在しない、またはNULLなら右側を使います。
'' = 空文字です。
!== = 値または型が同じではないことを厳密に比較します。
'admin' = 管理者を表すroleです。

→ roleがadminではない場合に処理を拒否します。
📘 ?? を分解する
$_SESSION['role'] ?? ''

roleが存在する
→ roleの値を使う

roleが存在しない、またはNULL
→ 空文字''を使う

その結果を'admin'と比較しています。
📘 exit()
条件に当てはまった場合、 exit()でPHPの処理を終了します。

→ 画面上でリンクを消すだけではなく、 サーバー側の処理そのものを止めています。

writerがURLを直接指定しても、status変更処理は許可されません。

ポイント
「ボタンを表示しない」と「処理そのものを拒否する」は別です。

権限を持たないユーザーからの操作は、 PHP側でも拒否します。

STEP 6|管理画面もadmin専用にする

管理画面も、ログインしているだけではアクセスできないようにしました。

if (($_SESSION['role'] ?? '') !== 'admin') {
    exit('管理画面にはアクセスできません。');
}
📘 016との違い
016では主にuser_idを確認して、 「ログインしているか」を判定しました。

017ではさらにroleを確認して、 「管理画面を利用する権限があるか」を判定します。

user_id → 認証状態の確認
role → 認可の判断

→ ログイン済みでも、権限がなければ処理を拒否できます。

writerが管理画面のURLを直接開いても拒否されます。

📘 3つの条件を整理する

今回の権限管理では、主に3種類の情報を使っています。

role
→ このユーザーはadminかwriterか?

author_id
→ この記事は誰が書いたものか?

status
→ この記事は現在どんな状態か?

→ 「ユーザーの役割」「記事の所有者」「記事の状態」を組み合わせて、 操作を許可するか拒否するか判断します。

📘 科目Bにつなげる:複数条件による判定

writerが記事を編集しようとした場合を考えます。

ログインしているか?
↓
writer本人の記事か?
↓
編集できるstatusか?
↓
条件を満たす → 編集を許可
条件を満たさない → 拒否

→ 1つの条件だけではなく、 複数の条件を順番に確認して結果を決めています。

今回の仕組み

ユーザー
↓
login.php
↓
session
↓
roleを確認
↓
author_idを確認
↓
article statusを確認
↓
操作を許可 / 拒否

今回は、認証したユーザーの情報をセッションに保存し、 role・author_id・statusを使って操作できる範囲を決めました。

📘 016と017のつながり

016
セッションのuser_idを確認し、 ログインしているかどうかを判定しました。

017
ログイン後さらにrole・author_id・statusを確認し、 そのユーザーに操作を許可するか判断します。

→ 016は主に認証状態の確認、 017は認可へ進んだ回です。

📘 処理の流れを読む

入力:ログインユーザー・操作対象の記事
↓
条件①:roleは何か?
↓
条件②:記事のauthor_idは誰か?
↓
条件③:記事のstatusは何か?
↓
処理:条件に応じて操作を許可または拒否
↓
出力:利用できる記事・操作だけを表示/実行

→ 「入力 → 複数条件の判定 → 処理 → 出力」という流れです。

📝 今回の忘備録

ログインしていることと、権限があることは別。

admin / writerというroleだけでなく、 記事のauthor_idとstatusも使って操作できる範囲を判断する。

また、画面上でリンクを隠すだけではなく、 PHP側でも権限チェックを行う。

URLを直接指定されることも考えて、 各処理ページでアクセス権を確認する。

この先やること

タグ: PHP / MariaDB / SQL / CMS / Authentication / Authorization / Session / role / author_id / status / 権限管理