公開記事だけを表示する
MariaDBのstatusを使い、publishedの記事だけを一般公開側に表示します。
🎯 目的
DBに保存されている記事のうち、公開状態の記事だけを表示します。
下書きの記事は一般公開側には表示しません。
今回やること
- MariaDBへ接続する
- articlesテーブルから記事を取得する
- statusがpublishedの記事だけに絞る
- 公開記事を一覧表示する
articles
↓
status = published
↓
公開記事だけ取得
↓
public-list.php
↓
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を読む
→ articlesにあるすべての記事ではなく、publishedの記事だけを取得しています。
$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
がある場合、
→ draftの記事は、SQLの検索結果に入りません。
例えば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の反復処理がここまでであることを示します。
📘 リンク部分を読む
→ 記事タイトルをクリックすると、その記事のslugを個別記事ページへ渡せます。
<a href="..."> = 別のページへ移動するリンクを作ります。?slug= = URLのクエリ文字列としてslugを渡します。urlencode() = slugをURLで扱える形式に変換します。htmlspecialchars() = タイトルに含まれるHTML上の特殊文字をエスケープして表示します。→ 記事タイトルをクリックすると、その記事のslugを個別記事ページへ渡せます。
📘 科目Bにつなげる:絞り込み+反復
今回は2種類の処理が組み合わさっています。
条件:publishedの記事だけをSQLで取得する
↓
反復:取得した記事をforeachで1件ずつ表示する
→ 「条件に合うデータを選ぶ」→「選んだデータを順番に処理する」という流れです。
今回は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
↓
一般公開されない
↓
一般公開される
draft
↓
一般公開されない
📘 なぜ表示されなくなる?
PHP側で後から隠しているのではなく、SQLの時点で
→ draftの記事は、一般公開用の検索結果そのものに含まれません。
PHP側で後から隠しているのではなく、SQLの時点で
WHERE status = 'published'
という条件を付けています。→ draftの記事は、一般公開用の検索結果そのものに含まれません。
今回の仕組み
articles
↓
WHERE status = 'published'
↓
publishedの記事だけ取得
↓
foreachで1件ずつ処理
↓
public-list.phpに表示
↓
WHERE status = 'published'
↓
publishedの記事だけ取得
↓
foreachで1件ずつ処理
↓
public-list.phpに表示
📘 処理の流れを読む
今回は「DBにある記事を公開状態で絞り込み、一覧として表示する」処理です。
入力:articlesテーブルに複数の記事が保存されている
↓
条件:WHEREでstatusがpublishedの記事だけに絞る
↓
処理①:条件に一致した記事をDBから取得する
↓
処理②:foreachで記事を1件ずつ取り出す
↓
出力:記事タイトルと個別記事へのリンクを表示する
→ 「絞り込み → 反復 → 出力」という流れになっています。
入力:articlesテーブルに複数の記事が保存されている
↓
条件:WHEREでstatusがpublishedの記事だけに絞る
↓
処理①:条件に一致した記事をDBから取得する
↓
処理②:foreachで記事を1件ずつ取り出す
↓
出力:記事タイトルと個別記事へのリンクを表示する
→ 「絞り込み → 反復 → 出力」という流れになっています。
📘 009と010のつながり
009
statusを書き換える。
010
statusを条件として使う。
→ DBにstatusを保存するだけではなく、その値を使ってプログラムの動きを変えています。
statusを書き換える。
draft ↔ published010
statusを条件として使う。
WHERE status = 'published'→ DBにstatusを保存するだけではなく、その値を使ってプログラムの動きを変えています。
📝 今回の忘備録
statusを使って、公開記事と下書きを分ける。WHEREで条件に合うデータだけを取得する。一般公開側では
status = 'published'の記事だけ取得する。取得した複数の記事は
foreachで1件ずつ表示する。
ここまでのCMS骨格
- Create:記事追加
- Read:記事一覧・個別表示
- Update:記事編集
- Delete:記事削除
- Status:draft / published
- Public:publishedだけ一般公開
この先やること
- 管理画面を整理する
- ログイン・認証を追加する
- 公開側の記事詳細を整理する