【PHP8.x】ALTER_TABLE定数の使い方

Copy
1<?php
2
3// SQLite3 データベースを操作するクラス
4class SQLite3Example
5{
6    private $db;
7
8    public function __construct(string $dbPath)
9    {
10        try {
11            $this->db = new SQLite3($dbPath);
12        } catch (Exception $e) {
13            die("データベース接続エラー: " . $e->getMessage());
14        }
15    }
16
17    public function alterTableAddColumn(string $tableName, string $columnName, string $columnType): bool
18    {
19        // ALTER TABLE ステートメントを構築
20        $sql = "ALTER TABLE " . $tableName . " ADD COLUMN " . $columnName . " " . $columnType;
21
22        // クエリを実行
23        try {
24            $result = $this->db->exec($sql);
25            return $result;
26        } catch (Exception $e) {
27            echo "テーブル変更エラー: " . $e->getMessage() . PHP_EOL;
28            return false;
29        }
30    }
31
32    public function close(): void
33    {
34        $this->db->close();
35    }
36}
37
38// データベースファイルのパス
39$dbPath = 'test.db';
40
41// SQLite3Example クラスのインスタンスを作成
42$example = new SQLite3Example($dbPath);
43
44// テーブルが存在しない場合に作成する関数 (必要に応じて)
45function createTableIfNotExists(SQLite3 $db, string $tableName): void
46{
47    $sql = "CREATE TABLE IF NOT EXISTS " . $tableName . " (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)";
48    $db->exec($sql);
49}
50
51// データベースに接続
52$db = new SQLite3($dbPath);
53
54// テーブルを作成 (存在しない場合)
55createTableIfNotExists($db, 'users');
56
57$db->close();
58
59// 'users' テーブルに新しいカラム 'email' を追加
60$tableName = 'users';
61$columnName = 'email';
62$columnType = 'TEXT';
63
64if ($example->alterTableAddColumn($tableName, $columnName, $columnType)) {
65    echo "テーブル '$tableName' にカラム '$columnName' が追加されました。" . PHP_EOL;
66} else {
67    echo "テーブル '$tableName' へのカラム '$columnName' の追加に失敗しました。" . PHP_EOL;
68}
69
70// データベース接続を閉じる
71$example->close();
72
73?>

このサンプルコードは、PHPのSQLite3拡張を用いて、SQLiteデータベースのテーブルに新しいカラムを追加する方法を示します。SQLite3::ALTER_TABLE定数自体は直接利用しませんが、ALTER TABLE SQLコマンドを実行することでカラム追加を実現します。

まず、SQLite3Exampleクラスを定義し、コンストラクタでデータベースへの接続を確立します。alterTableAddColumnメソッドは、テーブル名、カラム名、カラムの型を引数に取り、ALTER TABLE ADD COLUMN SQLクエリを生成して実行します。クエリの実行結果は真偽値で返され、成功した場合はtrue、失敗した場合はfalseとなります。失敗時にはエラーメッセージが出力されます。

サンプルでは、まずtest.dbというデータベースファイルへの接続を試みます。次に、usersテーブルが存在しない場合に作成する関数createTableIfNotExistsを定義し、テーブルが存在しない場合に作成します。その後、alterTableAddColumnメソッドを使ってusersテーブルにemailというTEXT型のカラムを追加します。最後に、データベースへの接続を閉じます。

この例では、ALTER TABLEコマンドを文字列として組み立て、SQLite3::exec()メソッドを使って実行しています。SQLite3::ALTER_TABLE定数は、エラー処理や定義確認のために利用できます。alterTableAddColumnメソッドは、テーブルの構造を変更するSQL文を組み立て、実行する処理をカプセル化することで、コードの再利用性と可読性を高めています。

Copy
1<?php
2
3/**
4 * SQLite3 ALTER TABLE の使用例
5 *
6 * AUTO_INCREMENT は SQLite3 では直接サポートされていません。
7 * 代わりに、INTEGER PRIMARY KEY で AUTOINCREMENT を実現できます。
8 */
9
10// SQLite3 データベースに接続
11$db = new SQLite3('test.db');
12
13// テーブルを作成 (id は INTEGER PRIMARY KEY AUTOINCREMENT として定義)
14$db->exec("
15    CREATE TABLE IF NOT EXISTS users (
16        id INTEGER PRIMARY KEY AUTOINCREMENT,
17        name TEXT,
18        email TEXT
19    )
20");
21
22// データを挿入
23$db->exec("INSERT INTO users (name, email) VALUES ('John Doe', 'john.doe@example.com')");
24$db->exec("INSERT INTO users (name, email) VALUES ('Jane Doe', 'jane.doe@example.com')");
25
26// データを取得
27$result = $db->query('SELECT * FROM users');
28
29// 結果を表示
30while ($row = $result->fetchArray()) {
31    echo "ID: " . $row['id'] . ", Name: " . $row['name'] . ", Email: " . $row['email'] . "\n";
32}
33
34// データベースを閉じる
35$db->close();
36
37?>

このサンプルコードは、PHPのSQLite3拡張を用いてデータベースを操作する基本的な例を示しています。SQLite3::ALTER_TABLE 定数は、テーブルの構造を変更する際に利用できますが、SQLite3ではAUTO_INCREMENTを直接サポートしていません。

このコードでは、まずSQLite3データベースに接続し、usersテーブルが存在しない場合は作成します。idカラムは INTEGER PRIMARY KEY AUTOINCREMENT として定義されており、これはSQLite3で自動インクリメントを実現するための一般的な方法です。つまり、新しいレコードが挿入されるたびに、idの値が自動的に増加します。

次に、サンプルデータをusersテーブルに挿入します。nameとemailをそれぞれ設定しています。

その後、SELECTクエリを実行してusersテーブルからすべてのデータを取得し、結果をループで処理して各行のid、name、emailを表示します。

最後に、データベース接続を閉じます。SQLite3::ALTER_TABLE定数自体は直接使用されていませんが、このコードはテーブル構造を変更するための準備段階として、自動インクリメントを設定する方法を示しています。この例では、idカラムをINTEGER PRIMARY KEY AUTOINCREMENTとして定義することで、自動的に連番が割り振られるようにしています。SQLite3::ALTER_TABLE 定数はテーブル構造の変更時に使用される整数値を表しますが、具体的な値や直接的な利用方法はSQLite3のバージョンや設定によって異なります。