記事一覧から個別記事を表示する
記事一覧からslugを渡し、DBから個別の記事を表示します。
🎯 目的
記事一覧から記事を選びます。
選んだ記事を個別に表示します。
今回やること
- 記事一覧を表示する
- slugをリンクに渡す
- PHPでslugを受け取る
- DBから記事を取得する
- 記事を表示する
記事一覧
↓
slug
↓
PHP
↓
MariaDB
↓
個別記事
↓
slug
↓
PHP
↓
MariaDB
↓
個別記事
STEP 1|記事一覧を作る
DBから記事を取得します。
SELECT id, title, slug, status, created_at
FROM articles
ORDER BY id DESC
📘 SQLを読む
→ 記事一覧に必要なデータを、新しいidから順番に取得しています。
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を読む
例えばURLは、
のようになります。
→ 「どの記事を表示するか」をslugで次のPHPへ渡しています。
<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コードを読む
→ slugがあれば処理を続け、slugが空なら「記事が指定されていません。」と表示して終了します。
$_GET = URLのクエリ文字列から渡された値を受け取るPHPのスーパーグローバル変数です。$_GET['slug'] = URLのslug=...の値を取り出します。?? = null合体演算子です。左側の値が存在し、nullでなければその値を使い、そうでなければ右側の値を使います。'' = 空文字列です。文字が何も入っていない状態を表します。if = 条件によって処理を分ける「条件分岐」です。=== = 値と型の両方が同じかを比較する演算子です。exit() = PHPの処理をそこで終了します。→ slugがあれば処理を続け、slugが空なら「記事が指定されていません。」と表示して終了します。
📘 科目Bにつなげる:条件分岐
この処理は、条件によって次の処理を変えています。
slugは空か?
↓
YES → メッセージを表示して終了
NO → DB検索へ進む
→
この処理は、条件によって次の処理を変えています。
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を読む
→ URLから受け取ったslugを検索条件にして、該当する1件の記事を取得しています。
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文字列へ直接つなげず、
→ プリペアドステートメントを正しく使うことは、SQLインジェクション対策として重要です。
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では
そのため、bodyに保存されたHTMLタグもHTMLとして解釈されます。
→ 記事本文でHTMLを使う設計では必要な場合がありますが、信頼できない入力をそのまま保存・表示するとXSSなどの危険があるため注意が必要です。
titleでは
htmlspecialchars()を使っていますが、ここではbodyをそのまま出力しています。そのため、bodyに保存されたHTMLタグもHTMLとして解釈されます。
→ 記事本文でHTMLを使う設計では必要な場合がありますが、信頼できない入力をそのまま保存・表示するとXSSなどの危険があるため注意が必要です。
STEP 6|ブラウザで確認する
記事のURLを開きます。
http://it-textbook.duckdns.org/article-detail.php?slug=vps-php-test
成功
DBに保存した記事が表示されれば成功です。
DBに保存した記事が表示されれば成功です。
今回の仕組み
記事一覧
↓
slugをURLに付ける
↓
PHPが$_GETで受け取る
↓
SQLのWHEREで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件を選ぶ」処理を行っています。
入力:URLからslugを受け取る
↓
条件分岐:slugが空かどうかをifで判定する
↓
処理①:slugをプレースホルダーへ渡してSQLを実行する
↓
処理②:MariaDBのarticlesテーブルから条件に合う1件を取得する
↓
出力:取得したtitleとbodyをHTMLへ組み込み、ブラウザに表示する
→ 004では複数の記事を繰り返し表示しましたが、005では「slugという条件を使って1件を選ぶ」処理を行っています。
📝 今回の忘備録
記事を指定するときはslugを使う。
URLの値は
DB検索にはプリペアドステートメントを使う。
URLの値は
$_GETで受け取れる。ifを使うと条件によって処理を分けられる。DB検索にはプリペアドステートメントを使う。
この先やること
- 記事を追加する
- 記事を編集する
- 記事を削除する