PHP + MariaDBで公開記事一覧を作る

MariaDBから公開記事を取得し、タイトル検索、0件表示、画像表示、Aboutページまで実装します。

🎯 今回のゴール

前回までに作ったMariaDBとPHPの接続を使って、 今回は実際の公開記事一覧を作ります。

「DBから記事を取得する」だけではなく、 公開状態の記事だけを表示すること、検索すること、画像を表示すること まで実装します。

今回作る仕組み

ブラウザ
↓ HTTPS
nginx
↓
PHP-FPM
↓
index.php
↓
PDO
↓
MariaDB
↓
articles
↓
公開記事
↓
HTML
↓
ブラウザ
📘 旧musikyunでは?
旧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();
📘 WHERE status = 'published'とは?
articlesには、 draft、 in_review、 needs_revision、 published、 closed などの記事状態があります。

公開ページでは、 publishedの記事だけ を表示します。
📘 ORDER BY created_at DESCとは?
ORDER BYは並び順を指定します。
created_atは作成日時。
DESCは新しいものから並べる指定です。

STEP 2|タイトル検索を追加する

次に、検索フォームからタイトルを検索できるようにします。

$keyword = $_GET['q'] ?? '';
📘 $_GETとは?
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();
📘 なぜprepare()を使う?
ユーザーが入力した検索文字をSQLへそのまま埋め込むのではなく、 プレースホルダを使って値として渡します。

今回なら、 :keyword がプレースホルダです。
📘 LIKEと%とは?
LIKEは文字列の部分一致検索に使います。

%音楽% なら、 「音楽」を含むタイトルを検索できます。

STEP 4|検索結果0件を表示する

検索結果が何もない場合、何も表示されないだけでは分かりにくいので、 メッセージを表示します。

<?php if (empty($articles)): ?>

    <p>記事がありません。</p>

<?php else: ?>

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

        ...

    <?php endforeach; ?>

<?php endif; ?>
📘 empty()とは?
配列などが空かどうかを確認します。

今回、 $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; ?>
📘 htmlspecialchars()はなぜ必要?
DBから取得した文字列を、 HTMLとしてそのまま解釈させないためです。

これはXSS対策の基本の一つです。
📘 foreachとは?
配列の中身を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/
📘 scpとは?
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;
📘 DBには何を保存する?
今回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; ?>
Macの hero.png
↓
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
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ページを作った。
・ブラウザで一連の動作を確認した。
PHP MariaDB PDO SQL Linux nginx PHP-FPM 画像 CMS