公開記事だけを表示する

MariaDBのstatusを使い、publishedの記事だけを一般公開側に表示します。

🎯 目的

DBに保存されている記事のうち、公開状態の記事だけを表示します。

下書きの記事は一般公開側には表示しません。

今回やること

  1. MariaDBへ接続する
  2. articlesテーブルから記事を取得する
  3. statusがpublishedの記事だけに絞る
  4. 公開記事を一覧表示する
articles
↓
status = published
↓
公開記事だけ取得
↓
public-list.php

STEP 1|公開記事だけ取得する

SQLのWHERE句で、statusがpublishedの記事だけに絞ります。

$stmt = $pdo->query(
    "SELECT id, title, slug, body, created_at
     FROM articles
     WHERE status = 'published'
     ORDER BY id DESC"
);
📘 SQLを読む
$pdo->query() = SQLをDBへ送り、実行します。
SELECT = DBからデータを取得します。
id, title, slug, body, created_at = 取得するカラムです。
FROM articles = articlesテーブルから取得します。
WHERE = 条件に一致する行だけに絞り込みます。
status = 'published' = statusがpublishedの行だけを対象にします。
ORDER BY id DESC = idを基準に大きい順へ並べます。
DESC = descending(降順)です。

→ articlesにあるすべての記事ではなく、publishedの記事だけを取得しています。
📘 WHEREは「条件で絞る」
例えばDBに、

記事A → published
記事B → draft
記事C → published

がある場合、WHERE status = 'published'を使うと、記事Aと記事Cが取得対象になります。

→ draftの記事は、SQLの検索結果に入りません。

STEP 2|取得した記事を表示する

取得した記事をforeachで1件ずつ表示します。

<?php foreach ($articles as $article): ?>

    <a href="article-detail.php?slug=<?=
        urlencode($article['slug'])
    ?>">

        <?= htmlspecialchars($article['title']) ?>

    </a>

<?php endforeach; ?>
📘 PHPを読む
foreach = 配列などのデータを1件ずつ順番に処理する反復処理です。
$articles = 取得した複数の記事が入っています。
as $article = その中から1件ずつ取り出し、$articleとして扱います。
$article['slug'] = 現在処理している記事のslugです。
$article['title'] = 現在処理している記事のタイトルです。
endforeach = foreachの反復処理がここまでであることを示します。
📘 リンク部分を読む
<a href="..."> = 別のページへ移動するリンクを作ります。
?slug= = URLのクエリ文字列としてslugを渡します。
urlencode() = slugをURLで扱える形式に変換します。
htmlspecialchars() = タイトルに含まれるHTML上の特殊文字をエスケープして表示します。

→ 記事タイトルをクリックすると、その記事のslugを個別記事ページへ渡せます。
📘 科目Bにつなげる:絞り込み+反復
今回は2種類の処理が組み合わさっています。

条件:publishedの記事だけをSQLで取得する
↓
反復:取得した記事をforeachで1件ずつ表示する

→ 「条件に合うデータを選ぶ」→「選んだデータを順番に処理する」という流れです。

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

公開記事一覧を開きます。

http://it-textbook.duckdns.org/public-list.php

現在は「VPSにPHPのテストページを表示する」が publishedなので表示されます。

確認結果
公開記事だけが表示されました。

STEP 4|draftとの違い

記事のstatusをdraftにすると、 public-list.phpでは表示されません。

published
↓
一般公開される

draft
↓
一般公開されない
📘 なぜ表示されなくなる?
PHP側で後から隠しているのではなく、SQLの時点で WHERE status = 'published' という条件を付けています。

→ draftの記事は、一般公開用の検索結果そのものに含まれません。

今回の仕組み

articles
↓
WHERE status = 'published'
↓
publishedの記事だけ取得
↓
foreachで1件ずつ処理
↓
public-list.phpに表示

📘 処理の流れを読む

今回は「DBにある記事を公開状態で絞り込み、一覧として表示する」処理です。

入力:articlesテーブルに複数の記事が保存されている
↓
条件:WHEREでstatusがpublishedの記事だけに絞る
↓
処理①:条件に一致した記事をDBから取得する
↓
処理②:foreachで記事を1件ずつ取り出す
↓
出力:記事タイトルと個別記事へのリンクを表示する

→ 「絞り込み → 反復 → 出力」という流れになっています。

📘 009と010のつながり

009
statusを書き換える。
draft ↔ published

010
statusを条件として使う。
WHERE status = 'published'

→ DBにstatusを保存するだけではなく、その値を使ってプログラムの動きを変えています。

📝 今回の忘備録

statusを使って、公開記事と下書きを分ける。
WHEREで条件に合うデータだけを取得する。
一般公開側ではstatus = 'published'の記事だけ取得する。
取得した複数の記事はforeachで1件ずつ表示する。

ここまでのCMS骨格

この先やること

タグ: PHP / MariaDB / SQL / PDO / SELECT / WHERE / foreach / status / CMS / VPS