topic: db (PDO / SQL / マルチDB)

PDO 経由で RDB を操作するトピック。SQLite を既定 に、DOJO_DB_DRIVER=mysql|pgsql で MySQL / PostgreSQL にも接続できる構造で組んである。

このトピックで身につくこと

• PDO で DB に接続して SELECT / INSERT / UPDATE / DELETE を実行できる
• プレースホルダ (? / :name) で値を差し込み、SQL インジェクションを防げる
• fetch / fetchAll / fetchColumn のモードを使い分けられる
• トランザクション (beginTransaction / commit / rollBack) で複数 SQL をまとめられる
• SQLite / MySQL / PostgreSQL の DSN の違い と 方言の差 を読み分けられる

前提知識の要点

連想配列 (['key' => 値]) が読めれば start できる。クラス・例外は必須ではない (new PDO(...) と try/catch だけ書ければよい)。

// PDO の最小コード
$pdo = new PDO('sqlite:' . getenv('DOJO_DB_PATH'));
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

$stmt = $pdo->prepare('SELECT name FROM users WHERE age >= ?');
$stmt->execute([20]);
foreach ($stmt as $row) {
    echo $row['name'], "\n";
}

• new PDO(<DSN>) で接続。DSN は 「どの DB のどこに繋ぐか」 を表す文字列
• setAttribute(ERRMODE_EXCEPTION) を付けて例外で気付く形にする (これ無しは事故の元)
• 値を SQL に埋めるときは 必ず prepare + execute。"WHERE name = '$name'" と連結すると SQL インジェクションになる

chapter 一覧

合計 12 chapter / 25 drill / 所要 3〜4 時間。

採点ランナーと DB の関係

採点ランナーは 既定で SQLite を一時ファイルに作って tests/setup.sql を流し込み、そのパスを環境変数 DOJO_DB_PATH として受講生コードに渡す。

# 既定 (SQLite)
php scripts/grade.php topics/db/ch03-select-basic/drill/01-select-all/

# MySQL コンテナ側で採点
DOJO_DB_DRIVER=mysql php scripts/grade.php topics/db/ch11-mysql-specific/drill/01-...

# PostgreSQL コンテナ側で採点
DOJO_DB_DRIVER=pgsql php scripts/grade.php topics/db/ch12-postgres-specific/drill/01-...

ch11 / ch12 は その DB 専用の SQL (例: MySQL の AUTO_INCREMENT、PostgreSQL の RETURNING) を扱うので、setup.mysql.sql / setup.pgsql.sql で方言差を吸収している。Docker は docker/compose.yml を docker compose up -d で立てる (詳細は docker/README.md)。

進め方

1. 各 chapter の slide.md を読む (4〜5 分)
2. drill/ 配下の問題を順番に解く (ch01 は読むだけ)
3. 採点: php scripts/grade.php topics/db/<chapter>/drill/<drill>/
4. MySQL / PostgreSQL を試したい時だけ Docker を立てて DOJO_DB_DRIVER=... を付ける

つまづきポイント

関連トピック

トピックを並列で参照する全体地図は TOPICS_INDEX.md にある。

案件 (dojo_map.tsv) での参照

topic_slug    chapter_dir
db            topics/db/ch02-pdo-connect
db            topics/db/ch04-select-where
db            topics/db/ch08-transactions
db            topics/db/ch09-sql-injection
...

slug db で参照可。11-db / db どちらの path でもアクセスできる (シンボリックリンク)。