【PHP8.x】Pdo\Sqlite::exec()メソッドの使い方

Copy
1<?php
2
3/**
4 * PDO::exec メソッドを使用してSQLiteデータベースにテーブルを作成し、データを挿入するサンプル。
5 *
6 * PDO::exec は、結果セットを返さないSQLステートメント（DDL: CREATE, ALTER, DROP や DML: INSERT, UPDATE, DELETE）の実行に使用されます。
7 * 成功した場合は影響を受けた行数（DDLの場合は通常0）、失敗した場合は false を返します。
8 *
9 * システムエンジニアを目指す初心者向けに、基本的なデータベース操作の実行方法を示します。
10 */
11
12// データベースファイルのパスを指定
13$dbFile = 'sample.db';
14
15// 例外処理を導入し、エラーが発生した場合にメッセージを表示できるようにします。
16try {
17    // 1. SQLiteデータベースに接続
18    // 'sqlite:' の後にデータベースファイルのパスを指定します。
19    // PDO::ERRMODE_EXCEPTION を設定することで、エラー発生時にPDOExceptionをスローさせます。
20    $pdo = new PDO('sqlite:' . $dbFile, null, null, [
21        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
22    ]);
23
24    echo "データベース '{$dbFile}' に接続しました。\n";
25
26    // 2. `PDO::exec` メソッドを使用してテーブルを作成
27    $createTableSql = "
28        CREATE TABLE IF NOT EXISTS users (
29            id INTEGER PRIMARY KEY AUTOINCREMENT,
30            name TEXT NOT NULL,
31            email TEXT UNIQUE NOT NULL
32        );
33    ";
34    // exec は成功した場合に影響を受けた行数（CREATE TABLEのようなDDLでは通常0）、
35    // 失敗した場合に false を返します。
36    $affectedRows = $pdo->exec($createTableSql);
37
38    if ($affectedRows !== false) {
39        echo "テーブル 'users' を作成または既に存在しています。\n";
40    } else {
41        echo "テーブル 'users' の作成に失敗しました。\n";
42    }
43
44    // 3. `PDO::exec` メソッドを使用してデータを挿入
45    $insertDataSql = "
46        INSERT INTO users (name, email) VALUES
47        ('田中 太郎', 'tanaka.t@example.com'),
48        ('佐藤 花子', 'sato.h@example.com');
49    ";
50    // exec は成功した場合に影響を受けた行数（この場合は挿入された行数）、
51    // 失敗した場合に false を返します。
52    $affectedRows = $pdo->exec($insertDataSql);
53
54    if ($affectedRows !== false) {
55        echo "{$affectedRows} 件のデータを 'users' テーブルに挿入しました。\n";
56    } else {
57        echo "データの挿入に失敗しました。\n";
58    }
59
60    // 4. (オプション) データベース接続を閉じる
61    // PHPスクリプトの実行終了時に自動的に閉じられますが、明示的にnullを設定することも可能です。
62    $pdo = null;
63    echo "データベース接続を閉じました。\n";
64
65} catch (PDOException $e) {
66    // データベース操作中にエラーが発生した場合、ここで捕捉されます。
67    echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
68} finally {
69    // スクリプト終了後のクリーンアップ（任意）
70    // 生成されたデータベースファイルを削除したい場合は、以下のコメントアウトを解除します。
71    // if (file_exists($dbFile)) {
72    //     unlink($dbFile);
73    //     echo "データベースファイル '{$dbFile}' を削除しました。\n";
74    // }
75}

PHPのPDO::execメソッドは、データベースに対してSQLステートメントを実行するための機能です。このメソッドは、結果としてデータ（結果セット）を返さないSQLコマンド、例えばテーブルを作成するCREATE TABLE、データを追加するINSERT、更新するUPDATE、削除するDELETEなどに主に利用されます。

引数には実行したいSQLクエリの文字列を渡します。成功した場合の戻り値は、INSERTやUPDATE、DELETEのようなデータ操作言語（DML）では処理によって影響を受けた行数が整数で返されます。CREATE TABLEなどのデータ定義言語（DDL）の場合、通常は0が返されます。もしSQLの実行に失敗した場合はfalseが返されるため、エラー処理を行う際にこの戻り値を確認することが重要です。

サンプルコードでは、SQLiteデータベースに接続後、CREATE TABLE文でusersテーブルを作成し、続いてINSERT文でデータを挿入する一連の流れでPDO::execを使用しています。これにより、データベースの構造定義やデータ操作を簡単に行うことができるのです。