記事一覧から個別記事を表示する

記事一覧からslugを渡し、DBから個別の記事を表示します。

🎯 目的

記事一覧から記事を選びます。

選んだ記事を個別に表示します。

今回やること

  1. 記事一覧を表示する
  2. slugをリンクに渡す
  3. PHPでslugを受け取る
  4. DBから記事を取得する
  5. 記事を表示する
記事一覧
↓
slug
↓
PHP
↓
MariaDB
↓
個別記事

STEP 1|記事一覧を作る

DBから記事を取得します。

SELECT id, title, slug, status, created_at
FROM articles
ORDER BY id DESC
📘 SQLを読む
SELECT = DBからデータを取得します。
id, title, slug, status, created_at = 取得するカラムです。
FROM articles = articlesテーブルを対象にします。
ORDER BY = データの並び順を指定します。
id DESC = idを大きい順、つまり降順に並べます。
→ 記事一覧に必要なデータを、新しいidから順番に取得しています。

取得した記事を一覧表示します。

STEP 2|slugを渡す

記事のリンクにslugを付けます。

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

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

</a>
📘 PHP・URLを読む
<a href="..."> = HTMLでリンクを作ります。
article-detail.php = リンク先のPHPファイルです。
? = URL本体と、後ろに付けるクエリ文字列を区切ります。
slug= = slugという名前で値を渡します。
$article['slug'] = 現在の記事のslugを取り出します。
urlencode() = 値をURLの一部として扱える形式に変換します。
htmlspecialchars() = HTMLで特別な意味を持つ文字を安全に表示できる形へ変換します。

例えばURLは、
article-detail.php?slug=vps-php-test
のようになります。
→ 「どの記事を表示するか」をslugで次のPHPへ渡しています。

今回は vps-php-test を使います。

STEP 3|slugを受け取る

PHPでslugを受け取ります。

$slug = $_GET['slug'] ?? '';

if ($slug === '') {
    exit('記事が指定されていません。');
}
📘 PHPコードを読む
$_GET = URLのクエリ文字列から渡された値を受け取るPHPのスーパーグローバル変数です。
$_GET['slug'] = URLのslug=...の値を取り出します。
?? = null合体演算子です。左側の値が存在し、nullでなければその値を使い、そうでなければ右側の値を使います。
'' = 空文字列です。文字が何も入っていない状態を表します。

if = 条件によって処理を分ける「条件分岐」です。
=== = 値と型の両方が同じかを比較する演算子です。
exit() = PHPの処理をそこで終了します。

→ slugがあれば処理を続け、slugが空なら「記事が指定されていません。」と表示して終了します。
📘 科目Bにつなげる:条件分岐
この処理は、条件によって次の処理を変えています。

slugは空か?
↓
YES → メッセージを表示して終了
NO → DB検索へ進む

→ if はアルゴリズムの基本構造である「分岐」です。

STEP 4|DBから記事を取得する

slugを使って記事を検索します。

$stmt = $pdo->prepare(
    'SELECT title, body, status
     FROM articles
     WHERE slug = ?'
);

$stmt->execute([$slug]);

$article = $stmt->fetch(PDO::FETCH_ASSOC);
📘 PHP・SQLを読む
prepare() = 値をあとから渡せる形でSQLを準備します。
SELECT title, body, status = title・body・statusを取得します。
FROM articles = articlesテーブルを検索します。
WHERE = 取得するデータの条件を指定します。
slug = ? = slugが指定した値と一致する記事を探します。
? = あとから値を入れるプレースホルダーです。

execute([$slug]) = プレースホルダーに$slugの値を渡してSQLを実行します。
fetch() = 検索結果から1行を取得します。
PDO::FETCH_ASSOC = カラム名をキーにした連想配列として取得します。
$article = 取得した1件の記事を保存します。

→ URLから受け取ったslugを検索条件にして、該当する1件の記事を取得しています。
📘 なぜprepare()を使う?
URLから受け取るslugは、外部から渡される値です。
値をSQL文字列へ直接つなげず、?とexecute()を使ってSQLの構造と値を分けます。
→ プリペアドステートメントを正しく使うことは、SQLインジェクション対策として重要です。

該当する記事を取得します。

STEP 5|個別記事を表示する

取得したタイトルを表示します。

<h1>
    <?= htmlspecialchars($article['title']) ?>
</h1>
📘 PHPコードを読む
<?= ... ?> = PHPの値をHTMLへ出力する短縮記法です。
$article['title'] = DBから取得した記事タイトルです。
htmlspecialchars() = HTMLの特殊文字をエスケープして、タイトルを文字として表示します。

本文も表示します。

<?= $article['body'] ?>
📘 titleとの違い
titleではhtmlspecialchars()を使っていますが、ここではbodyをそのまま出力しています。
そのため、bodyに保存されたHTMLタグもHTMLとして解釈されます。
→ 記事本文でHTMLを使う設計では必要な場合がありますが、信頼できない入力をそのまま保存・表示するとXSSなどの危険があるため注意が必要です。

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

記事のURLを開きます。

http://it-textbook.duckdns.org/article-detail.php?slug=vps-php-test
成功
DBに保存した記事が表示されれば成功です。

今回の仕組み

記事一覧
↓
slugをURLに付ける
↓
PHPが$_GETで受け取る
↓
SQLのWHEREでDBを検索
↓
個別記事を表示

記事そのものをURLに入れません。

slugを使って記事を指定します。

📘 処理の流れを読む

今回は「URLから条件を受け取り、その条件に合う記事をDBから探して表示する」処理です。

入力:URLからslugを受け取る
↓
条件分岐:slugが空かどうかをifで判定する
↓
処理①:slugをプレースホルダーへ渡してSQLを実行する
↓
処理②:MariaDBのarticlesテーブルから条件に合う1件を取得する
↓
出力:取得したtitleとbodyをHTMLへ組み込み、ブラウザに表示する

→ 004では複数の記事を繰り返し表示しましたが、005では「slugという条件を使って1件を選ぶ」処理を行っています。

📝 今回の忘備録

記事を指定するときはslugを使う。
URLの値は$_GETで受け取れる。
ifを使うと条件によって処理を分けられる。
DB検索にはプリペアドステートメントを使う。

この先やること

タグ: PHP / MariaDB / SQL / PDO / slug / GET / 条件分岐 / VPS / CMS