管理画面を整理する

記事の追加・一覧・表示・編集・公開状態・削除を管理画面からまとめて操作します。

🎯 目的

これまで個別に作った記事管理機能を、管理画面からまとめて操作できるようにします。

管理側と公開側の役割を分けます。

今回やること

  1. 管理画面を作る
  2. 記事を一覧表示する
  3. 記事追加へのリンクを用意する
  4. 記事表示へのリンクを用意する
  5. 記事編集へのリンクを用意する
  6. 公開・下書き変更へのリンクを用意する
  7. 削除へのリンクを用意する
  8. 公開記事一覧へのリンクを用意する
管理画面
↓
記事追加 / 表示 / 編集 / 公開・下書き / 削除
↓
MariaDB

公開側
↓
publishedの記事だけ表示

STEP 1|管理画面を作る

管理画面ではarticlesテーブルの記事を取得して表示します。

$stmt = $pdo->query(
    "SELECT id, title, slug, status
     FROM articles
     ORDER BY id DESC"
);

$articles = $stmt->fetchAll(PDO::FETCH_ASSOC);
📘 PHP・SQLを読む
$pdo = PHPからDBへ接続するためのPDOオブジェクトです。
query() = SQLをDBへ送り、実行します。
SELECT = DBからデータを取得します。
id, title, slug, status = 取得するカラムです。
FROM articles = articlesテーブルから取得します。
ORDER BY id DESC = idの大きい順に並べます。
DESC = descending(降順)です。

→ 管理画面なので、publishedだけに絞らず、articlesテーブルの記事を取得します。
📘 fetchAll()を読む
fetchAll() = SQLの検索結果をまとめて取得します。
PDO::FETCH_ASSOC = カラム名をキーにした連想配列として取得します。
$articles = 取得した複数の記事を保存する変数です。

→ この$articlesを使って、管理画面に複数の記事を並べられます。

STEP 2|記事追加へのリンク

新しい記事を作成する画面へ移動します。

<a href="article-add.php">
    + 記事を追加
</a>
📘 HTMLを読む
<a> = リンクを作るHTMLタグです。
href = リンク先を指定する属性です。
article-add.php = 記事追加画面です。

→ 管理画面そのものが記事を追加するのではなく、記事追加機能へ移動する入口になっています。

STEP 3|各記事の操作

記事ごとに、表示・編集・公開状態変更・削除へのリンクを用意します。

<a href="article-detail.php?slug=...">
    表示
</a>

<a href="article-edit.php?id=...">
    編集
</a>

<a href="article-status.php?id=...">
    公開・下書き
</a>

<a href="article-delete.php?id=...">
    削除
</a>
📘 URLを読む
article-detail.php?slug=... = slugを使って表示する記事を指定します。
article-edit.php?id=... = IDを使って編集する記事を指定します。
article-status.php?id=... = IDを使ってstatusを変更する記事を指定します。
article-delete.php?id=... = IDを使って削除対象の記事を指定します。

? = URL本体とクエリ文字列の区切りです。
id=...やslug=... = 移動先のPHPへ渡す値です。
📘 管理画面の役割
表示・編集・status変更・削除は、それぞれ別のPHPファイルが担当しています。

管理画面は、それらを1つの場所から選べるようにしています。

→ 1つの巨大な処理にするのではなく、役割ごとの処理をリンクでつないでいます。

STEP 4|statusを管理画面に表示する

記事ごとの現在のstatusも表示します。

<span class="status">
    <?= htmlspecialchars($article['status']) ?>
</span>
📘 HTML・PHPを読む
<span> = 文章の一部分をまとめるHTMLタグです。
class="status" = CSSなどからstatus部分を指定するためのクラス名です。
<?= ... ?> = PHPの値をHTMLへ出力する短縮記法です。
$article['status'] = 現在の記事のstatusです。
htmlspecialchars() = HTML上の特殊文字をエスケープして表示します。
確認しやすくなったこと
管理画面を見れば、各記事が draftなのか publishedなのか分かります。

STEP 5|ブラウザで確認する

管理画面を開きます。

http://it-textbook.duckdns.org/admin.php

以下の操作が表示されれば成功です。

  • 記事を追加
  • 記事一覧
  • 公開記事を見る
  • 表示
  • 編集
  • 公開・下書き
  • 削除
確認結果
管理画面から記事管理の各機能へ移動できました。

管理側と公開側

【管理側】
admin.php
↓
draftもpublishedも管理する

【公開側】
public-list.php
↓
publishedの記事だけ表示する
📘 管理側と公開側は目的が違う
管理側では、下書きの記事も編集・確認する必要があります。
そのためdraftとpublishedの両方を扱います。

公開側では、一般に見せる記事だけが必要です。
そのためstatus = 'published'の記事だけを表示します。

今回の仕組み

admin.php
↓
記事一覧を取得
↓
各記事の操作を選ぶ
↓
追加 / 表示 / 編集 / status変更 / 削除
↓
MariaDB

public-list.php
↓
publishedだけ一般公開

📘 処理の流れを読む

今回は「新しい処理を1つ作る」というより、 これまで作った複数の処理を管理画面から使えるようにまとめています。

入力:articlesテーブルに記事が保存されている
↓
処理①:SELECTで記事一覧を取得する
↓
処理②:fetchAll()で複数の記事を受け取る
↓
出力:管理画面に記事と操作リンクを表示する
↓
選択:追加・表示・編集・status変更・削除のどれかを選ぶ
↓
次の処理:選んだ機能を担当するPHPへ移動する

→ 管理画面が、複数の機能をつなぐ「入口」になっています。

📘 科目Bにつなげる:処理を分けて考える

CMS全体を1つの巨大な処理として見るのではなく、 役割ごとに分けると流れを追いやすくなります。

記事を作る → Create
記事を読む → Read
記事を直す → Update
記事を消す → Delete
公開状態を変える → Status
公開記事だけ選ぶ → Public
それらへの入口 → Admin

→ 大きな処理を小さな処理に分け、それぞれの役割とデータの流れを見る考え方です。

📝 今回の忘備録

管理画面を入口として、記事管理の各機能へ移動できるようにする。

SELECTで記事を取得する。
fetchAll()で複数の記事を受け取る。
リンクから各機能を担当するPHPへ移動する。

管理側ではdraftも含めて記事を管理する。
公開側ではpublishedの記事だけを表示する。

ここまでのCMS骨格

この先やること

タグ: PHP / MariaDB / SQL / PDO / SELECT / fetchAll / CRUD / CMS / Admin / VPS