【PHP8.x】readOnlyメソッドの使い方

Copy
1<?php
2
3class Database {
4    private SQLite3 $db;
5
6    public function __construct(string $filename) {
7        $this->db = new SQLite3($filename);
8    }
9
10    public function prepareStatement(string $sql): SQLite3Stmt {
11        return $this->db->prepare($sql);
12    }
13
14    public function close(): void {
15        $this->db->close();
16    }
17}
18
19
20try {
21    // データベースを作成 (存在する場合は開く)
22    $db = new Database('test.db');
23
24    // 読み取り専用のクエリ
25    $stmt = $db->prepareStatement('SELECT * FROM users WHERE id = :id');
26    $stmt->bindValue(':id', 1, SQLITE3_INTEGER);
27
28
29    // SQLite3Stmt::readOnly() を使用して、クエリが読み取り専用かどうかを確認
30    $readOnly = $stmt->readOnly();
31
32    if ($readOnly) {
33        echo "クエリは読み取り専用です。\n";
34    } else {
35        echo "クエリは読み取り/書き込み可能です。\n";
36    }
37
38
39    $result = $stmt->execute();
40    var_dump($result->fetchArray());
41
42
43    $db->close();
44
45
46    // データベース削除（テスト用）
47    unlink('test.db');
48
49} catch (Exception $e) {
50    echo "エラー: " . $e->getMessage() . "\n";
51}

このサンプルコードは、PHPのSQLite3拡張を用いて、データベースクエリが読み取り専用かどうかを判定する方法を示しています。SQLite3Stmt::readOnly()メソッドは、SQLite3Stmtオブジェクト（プリペアドステートメント）が読み取り専用のクエリであるかどうかをboolean値で返します。

まず、Databaseクラスを定義し、SQLite3データベースへの接続、プリペアドステートメントの作成、データベースのクローズ処理をカプセル化しています。prepareStatement()メソッドは、SQLクエリを受け取り、SQLite3Stmtオブジェクトを返します。

サンプルでは、test.dbという名前のデータベースを作成（または存在する場合は開きます）。次に、SELECT文を使用してユーザー情報を取得するプリペアドステートメントを作成し、bindValue()メソッドでパラメータをバインドしています。

$stmt->readOnly()を呼び出すことで、クエリが読み取り専用かどうかを確認できます。戻り値がtrueの場合、クエリは読み取り専用であり、falseの場合は読み取り/書き込み可能です。このサンプルコードでは、読み取り専用クエリの例としてSELECT文を使用しているため、$readOnlyはtrueになります。

最後に、execute()メソッドでクエリを実行し、結果を取得しています。テスト終了後、データベースファイルを削除しています。

この例では、readOnly()メソッドがクエリの性質を判断し、アプリケーションがデータベースに対して意図しない変更を加えるのを防ぐためにどのように役立つかを示しています。