PHP + MariaDBで公開記事一覧を作る
MariaDBから公開記事を取得し、タイトル検索、0件表示、画像表示、Aboutページまで実装します。
前回までに作ったMariaDBとPHPの接続を使って、 今回は実際の公開記事一覧を作ります。
「DBから記事を取得する」だけではなく、 公開状態の記事だけを表示すること、検索すること、画像を表示すること まで実装します。
今回作る仕組み
↓ HTTPS
nginx
↓
PHP-FPM
↓
index.php
↓
PDO
↓
MariaDB
↓
articles
↓
公開記事
↓
HTML
↓
ブラウザ
旧musikyunでは、記事データや画像をSupabaseが担当していました。
今回はその公開側を、 PHP + MariaDB + nginx で少しずつ再現していきます。
STEP 1|publishedの記事だけ取得する
まず、MariaDBのarticlesテーブルから記事を取得します。
$stmt = $pdo->query(
"SELECT
id,
title,
content,
image_url,
slug,
status,
created_at
FROM articles
WHERE status = 'published'
ORDER BY created_at DESC"
);
$articles = $stmt->fetchAll();
articlesには、
draft、
in_review、
needs_revision、
published、
closed
などの記事状態があります。公開ページでは、 publishedの記事だけ を表示します。
ORDER BYは並び順を指定します。created_atは作成日時。DESCは新しいものから並べる指定です。
STEP 2|タイトル検索を追加する
次に、検索フォームからタイトルを検索できるようにします。
$keyword = $_GET['q'] ?? '';
URLのクエリパラメータを取得するためのPHPの仕組みです。
たとえば、
?q=音楽
なら、
$keyword
に「音楽」が入ります。
検索文字がある場合はSQLの条件へ追加します。
$sql = "
SELECT
id,
title,
content,
image_url,
slug,
status,
created_at
FROM articles
WHERE status = 'published'
";
if ($keyword !== '') {
$sql .= " AND title LIKE :keyword";
}
$sql .= " ORDER BY created_at DESC";
STEP 3|prepare()で安全に検索する
検索文字をSQLへ直接連結するのではなく、
prepare()とプレースホルダを使います。
$stmt = $pdo->prepare($sql);
$params = [];
if ($keyword !== '') {
$params['keyword'] = '%' . $keyword . '%';
}
$stmt->execute($params);
$articles = $stmt->fetchAll();
ユーザーが入力した検索文字をSQLへそのまま埋め込むのではなく、 プレースホルダを使って値として渡します。
今回なら、
:keyword
がプレースホルダです。
LIKEは文字列の部分一致検索に使います。%音楽%
なら、
「音楽」を含むタイトルを検索できます。
STEP 4|検索結果0件を表示する
検索結果が何もない場合、何も表示されないだけでは分かりにくいので、 メッセージを表示します。
<?php if (empty($articles)): ?>
<p>記事がありません。</p>
<?php else: ?>
<?php foreach ($articles as $article): ?>
...
<?php endforeach; ?>
<?php endif; ?>
配列などが空かどうかを確認します。
今回、
$articles
が空なら「記事がありません。」を表示します。
実際に存在しない文字で検索し、 「記事がありません。」と表示されることを確認しました。
STEP 5|記事カードとして表示する
取得した記事を foreach で1件ずつ表示します。
<?php foreach ($articles as $article): ?>
<article>
<h2>
<?=
htmlspecialchars(
$article['title'],
ENT_QUOTES,
'UTF-8'
)
?>
</h2>
<p>
<?=
nl2br(
htmlspecialchars(
$article['content'],
ENT_QUOTES,
'UTF-8'
)
)
?>
</p>
</article>
<?php endforeach; ?>
DBから取得した文字列を、 HTMLとしてそのまま解釈させないためです。
これはXSS対策の基本の一つです。
配列の中身を1件ずつ順番に処理する反復処理です。
複数の記事があれば、 1記事ずつHTMLへ出力します。
STEP 6|画像をuploadsへ置く
次に記事画像を保存する場所を用意しました。
/var/www/musikyun/uploads
ディレクトリが存在することを確認します。
ls -ld /var/www/musikyun/uploads
Macにあるテスト画像 hero.png をVPSへ転送しました。
scp ~/Desktop/musikyun/src/assets/hero.png \
ubuntu@VPSのIPアドレス:/var/www/musikyun/uploads/
SSHを使ってファイルを安全にコピーするコマンドです。
今回は、 Mac → VPS へ画像を転送しました。
VPS側で確認します。
ls -l /var/www/musikyun/uploads
実際に hero.png が存在することを確認しました。
STEP 7|MariaDBにimage_urlを登録する
画像そのものをMariaDBへ保存するのではなく、 記事と画像を結びつけるために画像のURLを保存します。
UPDATE articles
SET image_url = '/uploads/hero.png'
WHERE id = 1;
今回MariaDBへ保存したのは画像ファイルそのものではありません。
/uploads/hero.png
という画像へのパスを保存しました。
登録後、
SELECT id, title, image_url
FROM articles;
として、image_urlが登録されていることを確認しました。
STEP 8|PHPから記事画像を表示する
PHPでimage_urlを取得し、 値がある場合だけ画像を表示します。
<?php if (!empty($article['image_url'])): ?>
<img
src="<?=
htmlspecialchars(
$article['image_url'],
ENT_QUOTES,
'UTF-8'
)
?>"
alt=""
>
<?php endif; ?>
↓
scp
↓
VPS /uploads/hero.png
↓
MariaDB image_url
↓
PHP
↓
<img>
↓
nginx
↓
ブラウザ
実際にブラウザから、
/uploads/hero.png
へアクセスし、
画像が表示されることを確認しました。
STEP 9|Aboutページを作る
公開ページのナビゲーションからアクセスできる Aboutページも作りました。
/var/www/musikyun/about.php
PHPの構文を確認します。
php -l /var/www/musikyun/about.php
文法エラーがないことを確認したあと、 ブラウザからAboutページを開きました。
Articles → 記事一覧
About → サイトについて というシンプルな構成にしています。
STEP 10|ブラウザで最終確認する
最後にブラウザからmusikyunへアクセスし、 実際の表示を確認しました。
MariaDBの記事をPHPから取得し、 publishedの記事だけを表示。
さらにタイトル検索、0件表示、 画像表示、Aboutページまで確認できました。
📘 全体の処理を追う
↓
nginx
↓
PHP-FPM
↓
index.php
↓
PDO
↓
MariaDB
↓
articles
↓
WHERE status = 'published'
↓
検索条件
↓
fetchAll()
↓
$articles
↓
foreach
↓
HTML
↓
nginx
↓
ブラウザ
📘 科目Bにつなげて考える
検索条件を受け取る → SQLを組み立てる → MariaDBへ送る → 結果を取得する → HTMLを作る、 という順番で処理します。
ifを使って、
「検索結果がある」
「検索結果がない」
を分けています。
また、image_urlがある場合だけ画像を表示します。
foreachを使って、
取得した記事を1件ずつ処理します。
fetchAll()で取得した複数の記事を
PHPの配列として扱います。
📘 入力 → 処理 → 出力
ブラウザから検索文字を入力
↓
【処理】
nginx
↓ PHP-FPM
↓ PHP
↓ PDO
↓ SQL
↓ MariaDB
↓ 検索
↓ fetchAll()
↓ foreach
↓ HTML生成
↓
【出力】
記事一覧
検索結果
記事画像
「記事がありません。」
MariaDBに保存した記事をPHPから取得し、 公開状態の記事だけを一覧表示できるようになりました。
さらに、タイトル検索、 検索結果0件の表示、 記事画像の表示、 Aboutページまで実装しました。
画像についても、 MacからVPSへ転送し、 MariaDBのimage_urlと結びつけ、 nginx経由でブラウザへ表示できることを確認しました。
まとめ
・publishedの記事だけを取得した。
・created_atの降順で記事を表示した。
・GETパラメータでタイトル検索を作った。
・prepare()とプレースホルダを使った。
・検索結果0件の表示を作った。
・foreachで記事を1件ずつ表示した。
・htmlspecialchars()でHTML出力を安全にした。
・uploadsディレクトリへ画像を配置した。
・scpでMacからVPSへ画像を転送した。
・MariaDBのimage_urlへ画像パスを登録した。
・PHPから記事画像を表示した。
・Aboutページを作った。
・ブラウザで一連の動作を確認した。