MariaDBを作ってPHPから記事を表示する

MariaDBに記事を保存し、PHPから読み出します。

🎯 目的

記事をデータベースに保存します。

PHPから記事を読み出します。

今回やること

  1. データベースを確認する
  2. テーブルを作る
  3. 記事を保存する
  4. DB専用ユーザーを作る
  5. PHPからDBへ接続する
  6. 記事を表示する
MariaDB
↓
articles
↓
PHP
↓
ブラウザ

STEP 1|データベースを確認する

MariaDBに入ります。

sudo mariadb
📘 コマンドを読む
sudo = 必要な権限を持つ別のユーザー(多くの場合 root)としてコマンドを実行します。
mariadb = MariaDBへ接続して操作するためのコマンドです。
→「必要な権限でMariaDBへ接続する」という意味です。

データベースを確認します。

SHOW DATABASES;
📘 SQLを読む
SHOW = 情報を表示します。
DATABASES = データベースの一覧を表します。
; = SQL文の終わりを示します。
→「存在するデータベースの一覧を表示する」という意味です。

今回は it_textbook_test を使います。

USE it_textbook_test;
📘 SQLを読む
USE = これから操作するデータベースを選択します。
it_textbook_test = 今回使用するデータベース名です。
→「以降の操作対象をit_textbook_testにする」という意味です。

STEP 2|テーブルを作る

記事を保存するテーブルを作ります。

CREATE TABLE articles (
    id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    slug VARCHAR(255) NOT NULL UNIQUE,
    body TEXT NOT NULL,
    status VARCHAR(30) NOT NULL DEFAULT 'draft',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
📘 SQLを読む
CREATE TABLE articles = articlesという名前のテーブルを作成します。
id = 記事を識別する番号です。
INT UNSIGNED = 0以上の整数を保存します。
AUTO_INCREMENT = 新しい行を追加すると番号を自動的に増やします。
PRIMARY KEY = 各行を一意に識別する主キーにします。

VARCHAR(255) = 最大255文字の可変長文字列を保存します。
TEXT = 比較的長い文章を保存します。
NOT NULL = NULLを許可せず、値を必須にします。
UNIQUE = 同じ値の重複を許可しません。
DEFAULT = 値を指定しなかった場合の初期値です。
TIMESTAMP = 日付と時刻を保存する型です。
CURRENT_TIMESTAMP = 現在の日時を使います。

→ 1件の記事を「ID・タイトル・slug・本文・状態・日時」に分けて保存できる構造を作っています。

作成できたか確認します。

SHOW TABLES;
📘 SQLを読む
SHOW TABLES; = 現在選択しているデータベース内のテーブル一覧を表示します。

次に構造を確認します。

DESCRIBE articles;
📘 SQLを読む
DESCRIBE = テーブルの構造を確認します。
articles = 確認するテーブル名です。
→ カラム名、データ型、NULLの可否、キーなどを確認できます。

STEP 3|記事を保存する

テスト記事を1件入れます。

INSERT INTO articles (title, slug, body, status)
VALUES (
    'VPSにPHPのテストページを表示する',
    'vps-php-test',
    '<p>VPSにPHPのテストページを表示します。</p>',
    'published'
);
📘 SQLを読む
INSERT INTO = テーブルへ新しいデータを追加します。
articles = 追加先のテーブルです。
(title, slug, body, status) = 値を入れるカラムを指定します。
VALUES = 実際に保存する値を指定します。
→ title、slug、body、statusの順番に、1件の記事データを保存しています。

保存できたか確認します。

SELECT id, title, slug, status
FROM articles;
📘 SQLを読む
SELECT = データを取得します。
id, title, slug, status = 取得するカラムです。
FROM = どのテーブルから取得するか指定します。
articles = 今回の取得元テーブルです。
→「articlesからID・タイトル・slug・状態を取得する」という意味です。

STEP 4|DB専用ユーザーを作る

PHPから使うユーザーを作ります。

CREATE USER 'it_textbook_user'@'localhost'
IDENTIFIED BY '自分で設定したパスワード';
📘 SQLを読む
CREATE USER = MariaDBを利用するユーザーを作成します。
'it_textbook_user'@'localhost' = localhostから接続するit_textbook_userを表します。
IDENTIFIED BY = そのユーザーが認証に使うパスワードを設定します。
→ PHPからDBへ接続するための専用ユーザーを作っています。

このユーザーにDBの権限を与えます。

GRANT ALL PRIVILEGES ON it_textbook_test.*
TO 'it_textbook_user'@'localhost';
📘 SQLを読む
GRANT = ユーザーへ権限を与えます。
ALL PRIVILEGES = 対象に対するすべての権限を与えます。
ON it_textbook_test.* = it_textbook_test内のすべてのテーブルを対象にします。
TO = 権限を与えるユーザーを指定します。
→ it_textbook_userに、it_textbook_testを操作する権限を与えています。
注意
パスワードは公開しません。

STEP 5|PHPからDBへ接続する

PDOを使って接続します。

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

$pdo->setAttribute(
    PDO::ATTR_ERRMODE,
    PDO::ERRMODE_EXCEPTION
);

echo 'DB接続OK';
📘 PHPコードを読む
PDO = PHP Data Objects。PHPからデータベースを操作するための仕組みです。
new PDO(...) = PDOオブジェクトを作り、データベースへ接続します。
mysql: = MySQL系データベース用のPDOドライバを使う指定です。
host=localhost = 同じサーバー上のDBへ接続します。
dbname=it_textbook_test = 接続するデータベース名です。
charset=utf8mb4 = 文字コードとしてutf8mb4を使います。

$pdo = 作成したPDOオブジェクトを保存する変数です。
-> = オブジェクトのメソッドやプロパティへアクセスするときに使う演算子です。
setAttribute() = PDOの設定を変更します。
PDO::ATTR_ERRMODE = エラー処理方法の設定項目です。
PDO::ERRMODE_EXCEPTION = DBでエラーが起きたとき例外を発生させます。
→ DBへ接続し、問題が起きた場合にエラーを検知しやすい設定にしています。

ブラウザで確認します。

http://it-textbook.duckdns.org/db-test.php
成功
「DB接続OK」と表示されれば成功です。

STEP 6|記事を表示する

DBから記事を読み出します。

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

$stmt->execute(['vps-php-test']);

$article = $stmt->fetch(PDO::FETCH_ASSOC);
📘 PHP・SQLを読む
prepare() = SQL文を実行する準備をします。
SELECT title, body = titleとbodyを取得します。
FROM articles = articlesテーブルから取得します。
WHERE = 取得する行の条件を指定します。
slug = ? = slugが指定した値と一致する行を探します。?は後から値を渡すためのプレースホルダです。

execute(['vps-php-test']) = ?へ値を渡してSQLを実行します。
fetch() = 実行結果から1行取得します。
PDO::FETCH_ASSOC = カラム名をキーにした連想配列として取得します。
$article = 取得した記事データを保存する変数です。
→「slugがvps-php-testの記事を探し、そのタイトルと本文を取得する」という処理です。

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

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

<?= $article['body'] ?>
📘 PHPコードを読む
<?= ... ?> = PHPの値を画面へ出力する短い書き方です。
$article['title'] = 取得した記事のtitleを取り出します。
htmlspecialchars() = HTMLで特別な意味を持つ文字を安全に表示できる形へ変換します。
$article['body'] = 取得した記事本文を出力します。
→ DBから取得したデータをHTMLとしてブラウザへ表示しています。

ブラウザで確認します。

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

今回の仕組み

MariaDB
↓
articlesテーブル
↓
PDO
↓
PHP
↓
ブラウザ

記事はMariaDBに保存します。

PHPが記事を読み出します。

ブラウザに表示します。

📘 処理の流れを読む
今回の処理は「入力 → 処理 → 出力」として整理できます。

入力:PHPから記事を取得する条件(slug)を指定する。
↓
処理:PDOを通してSQLを実行し、MariaDBのarticlesテーブルから条件に合う記事を取得する。
↓
出力:取得したtitleとbodyをPHPがHTMLへ組み込み、ブラウザに表示する。

→ 「どのデータを探すか」という条件を受け取り、DBから必要なデータを選び、結果を画面へ出力しています。

📝 今回の忘備録

DB接続にはPDOを使います。
DB専用ユーザーを作ります。
パスワードは公開しません。

この先やること

タグ: MariaDB / MySQL / PHP / PDO / SQL / データベース / VPS