【PHP8.x】PDOStatement::getAttribute()メソッドの使い方

Copy
1<?php
2
3/**
4 * PDOStatement::getAttribute の使用例。
5 * プリペアドステートメントの特定の属性を取得する方法を示します。
6 */
7function demonstratePdoStatementGetAttribute(): void
8{
9    // データベース接続設定 (SQLite インメモリデータベースを使用し、単体で動作可能にする)
10    $dsn = 'sqlite::memory:';
11    $username = null; // SQLiteの場合、通常ユーザー名とパスワードは不要
12    $password = null;
13    $options = [
14        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // エラー発生時に例外をスロー
15        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // デフォルトのフェッチモードを連想配列に設定
16    ];
17
18    try {
19        $pdo = new PDO($dsn, $username, $password, $options);
20        echo "データベースに接続しました。\n";
21
22        // テーブル作成 (例として products テーブル)
23        $pdo->exec("CREATE TABLE IF NOT EXISTS products (id INTEGER PRIMARY KEY, name TEXT, price REAL)");
24        echo "テーブル 'products' を作成しました。\n";
25
26        // ダミーデータの挿入
27        $pdo->exec("INSERT INTO products (name, price) VALUES ('Apple', 1.00)");
28        $pdo->exec("INSERT INTO products (name, price) VALUES ('Banana', 0.50)");
29        echo "ダミーデータを挿入しました。\n";
30
31        // プリペアドステートメントを作成し、PDO::prepare のオプションで属性を設定します。
32        // PDO::ATTR_CURSOR_NAME は、主にスクロール可能なカーソルで使用される属性ですが、
33        // PDOStatementオブジェクトに設定され、getAttributeで取得できる属性の良い例として使用します。
34        $stmt = $pdo->prepare(
35            'SELECT name, price FROM products WHERE id = :id',
36            [PDO::ATTR_CURSOR_NAME => 'product_query_cursor'] // ステートメントにカーソル名を設定
37        );
38        echo "プリペアドステートメントを作成し、カーソル名を設定しました。\n";
39
40        // PDOStatement::getAttribute を使用して、設定したカーソル名を取得します。
41        // 引数には取得したい属性の定数を指定します。
42        $cursorName = $stmt->getAttribute(PDO::ATTR_CURSOR_NAME);
43
44        if ($cursorName !== false) {
45            echo "PDOStatementから取得したカーソル名: " . $cursorName . "\n";
46        } else {
47            echo "カーソル名属性を取得できませんでした。\n";
48        }
49
50        // ステートメントの実行例 (属性の取得とは直接関係ありませんが、コードの流れとして示します)
51        $id = 1;
52        $stmt->bindParam(':id', $id, PDO::PARAM_INT);
53        $stmt->execute();
54        $result = $stmt->fetch();
55
56        if ($result) {
57            echo "取得した商品: " . $result['name'] . " (価格: " . $result['price'] . ")\n";
58        } else {
59            echo "指定されたIDの商品が見つかりませんでした。\n";
60        }
61
62        echo "処理を完了しました。\n";
63
64    } catch (PDOException $e) {
65        // データベース接続または操作でエラーが発生した場合
66        echo "データベースエラー: " . $e->getMessage() . "\n";
67        exit(1);
68    }
69}
70
71// 上記で定義した関数を実行します。
72demonstratePdoStatementGetAttribute();

PHPのPDOStatement::getAttributeメソッドは、データベース操作で使用する「プリペアドステートメント」（PDOStatementオブジェクト）に設定されている、特定の動作や状態に関する属性の値を取得するための機能です。これにより、ステートメントが内部的にどのような設定を持っているかを確認できます。

このメソッドの引数int $nameには、取得したい属性を表す定数を指定します。例えば、カーソル名を取得する場合にはPDO::ATTR_CURSOR_NAMEのような定数を指定します。戻り値はmixed型で、指定した属性に設定されている値が返されます。もしその属性が設定されていない場合や、取得できない場合にはfalseが返されるため、戻り値がfalseでないことを確認すると良いでしょう。

サンプルコードでは、まずデータベースへ接続し、次にPDO::prepareメソッドを使ってプリペアドステートメントを作成しています。このとき、PDO::ATTR_CURSOR_NAMEという属性に「product_query_cursor」という名前を設定しています。その後、$stmt->getAttribute(PDO::ATTR_CURSOR_NAME)を実行することで、作成したステートメントに設定したカーソル名を正確に取得し、画面に表示しています。このようにPDOStatement::getAttributeは、プリペアドステートメントの特定の振る舞いや設定値をプログラム上で確認する際に役立つメソッドです。