MariaDBから記事一覧を表示する

MariaDBに保存した記事を、PHPから取得して一覧表示します。

🎯 目的

MariaDBに保存した記事を取得します。

取得した記事をブラウザに一覧表示します。

今回やること

  1. MariaDBに接続する
  2. articlesテーブルから記事を取得する
  3. PHPで一覧を表示する
  4. ブラウザで確認する

今回の仕組み

MariaDB
↓
articles
↓
PHP
↓
記事一覧
↓
ブラウザ

STEP 1|MariaDBに接続する

PHPからMariaDBへ接続します。

$pdo = new PDO(
    'mysql:host=localhost;dbname=it_textbook_test;charset=utf8mb4',
    'it_textbook_user',
    '自分で設定したパスワード'
);

$pdo->setAttribute(
    PDO::ATTR_ERRMODE,
    PDO::ERRMODE_EXCEPTION
);
📘 PHPコードを読む
PDO = PHP Data Objects。PHPからデータベースを操作するための仕組みです。
new PDO(...) = PDOオブジェクトを作成し、データベースへ接続します。
host=localhost = 同じサーバー上のDBへ接続します。
dbname=it_textbook_test = 接続するデータベースを指定します。
charset=utf8mb4 = 文字コードを指定します。
setAttribute() = PDOの設定を変更します。
ERRMODE_EXCEPTION = DB処理でエラーが起きた場合に例外を発生させます。
→ PHPからMariaDBを操作する準備をしています。

STEP 2|記事を取得する

articlesテーブルから記事を取得します。

$stmt = $pdo->query(
    'SELECT id, title, slug, status, created_at
     FROM articles
     ORDER BY id DESC'
);

$articles = $stmt->fetchAll(PDO::FETCH_ASSOC);
📘 PHP・SQLを読む
query() = SQLをデータベースへ送って実行します。
SELECT = データを取得するSQLです。
id, title, slug, status, created_at = 取得するカラムを指定しています。
FROM articles = articlesテーブルから取得します。
ORDER BY = 結果を指定した順番に並べます。
id DESC = idを大きいものから小さいものへ降順に並べます。

$stmt = SQLの実行結果を扱うための変数です。
fetchAll() = 結果のすべての行をまとめて取得します。
PDO::FETCH_ASSOC = カラム名をキーにした連想配列として取得します。
$articles = 取得した複数の記事を保存する変数です。
→ articlesテーブルの記事を、idの新しい順にまとめて取得しています。

STEP 3|記事一覧を表示する

取得した記事をPHPで繰り返し表示します。

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

    <div class="article-item">

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

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

        </a>

        <div>
            status:
            <?=
                htmlspecialchars($article['status'])
            ?>
        </div>

    </div>

<?php endforeach; ?>
📘 PHPコードを読む
foreach = 複数のデータを1件ずつ順番に取り出して処理する反復処理です。
$articles as $article = $articlesから1件ずつ取り出し、その1件を$articleとして扱います。
endforeach = foreachの繰り返し範囲の終わりです。

$article['slug'] = 現在の記事のslugを取り出します。
urlencode() = URLの一部として安全に扱える形式へ変換します。
?slug= = URLにslugという名前の値を付けて次のページへ渡します。
$article['title'] = 現在の記事のタイトルを取り出します。
$article['status'] = 現在の記事の状態を取り出します。
htmlspecialchars() = HTMLで特別な意味を持つ文字を安全に表示できる形へ変換します。

→ 記事を1件取り出す → HTMLを作る → 次の記事を取り出す、という処理を記事の数だけ繰り返しています。
📘 科目Bにつなげる:反復処理
foreach は「同じ処理を繰り返す」というアルゴリズムの基本構造です。

1件目の記事を表示
↓
2件目の記事を表示
↓
3件目の記事を表示
↓
データがなくなったら終了

→ 記事が3件でも100件でも、同じ表示処理を繰り返せます。

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

作成したPHPファイルをブラウザで開きます。

http://it-textbook.duckdns.org/article-list.php
成功
MariaDBに保存した記事が一覧に表示されれば成功です。

📘 処理の流れを読む

今回は「DBから複数の記事を取得し、1件ずつ繰り返して表示する」処理です。

入力:articlesテーブルに保存されている記事データ
↓
処理①:SQLで記事をidの降順に取得する
↓
処理②:fetchAll()で複数の記事を$articlesへ入れる
↓
反復:foreachで記事を1件ずつ取り出してHTMLを作る
↓
出力:記事一覧をブラウザに表示する

→ 今回のポイントは、複数のデータに対して同じ処理を繰り返す「反復」です。

📝 今回の忘備録

DBに保存した記事は、PHPから取得できます。
複数の記事も、まとめて取得できます。
取得したデータをforeachで繰り返し表示できます。

この先やること

次は、記事一覧から個別の記事を表示します。