PDO::setAttribute

PHP PDO 参考手册PHP PDO リファレンスマニュアル

PDO::setAttribute — 属性を設定する(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


説明

構文

bool PDO::setAttribute ( int $attribute , mixed $value )

データベースハンドルの属性を設定します。以下に、利用可能ないくつかの一般的な属性を示します。一部のドライバは、追加の特定の属性を使用する場合があります。

  • PDO::ATTR_CASE:列名を指定された大文字小文字に強制します。

    • PDO::CASE_LOWER:列名を小文字に強制します。

    • PDO::CASE_NATURAL:データベースドライバが返す列名を保持します。

    • PDO::CASE_UPPER:列名を大文字に強制します。

  • PDO::ATTR_ERRMODE:エラー報告。

    • PDO::ERRMODE_SILENT:エラーコードのみを設定します。

    • PDO::ERRMODE_WARNING:発生させるE_WARNINGエラー

    • PDO::ERRMODE_EXCEPTION: スローするexceptions例外。

  • PDO::ATTR_ORACLE_NULLS(すべてのドライバで使用可能で、Oracleに限りません):NULLと空文字列を変換します。

    • PDO::NULL_NATURAL: 変換しません。

    • PDO::NULL_EMPTY_STRING:空文字列をNULLに変換しますNULL。

    • PDO::NULL_TO_STRING: NULLを空文字列に変換します。

  • PDO::ATTR_STRINGIFY_FETCHES: 取得時に数値を文字列に変換します。必要bool。

  • PDO::ATTR_STATEMENT_CLASS:PDOStatementから派生したユーザー提供のステートメントクラスを設定します。持続的なPDOインスタンスには使用できません。必要array(string クラス名, array(mixed コンストラクタの引数))。

  • PDO::ATTR_TIMEOUT:タイムアウトの秒数を指定します。すべてのドライバがこのオプションをサポートしているわけではなく、ドライバごとに差異がある可能性があります。たとえば、SQLiteはこの値に達するまで待機した後、書き込みロックの取得を放棄しますが、他のドライバはこの値を接続または読み取りタイムアウトの間隔として解釈する場合があります。int 型が必要です。

  • PDO::ATTR_AUTOCOMMIT(OCI、Firebird、MySQLで使用可能):各ステートメントを自動コミットするかどうか。

  • PDO::ATTR_EMULATE_PREPARESプリペアドステートメントのエミュレーションを有効または無効にします。一部のドライバはネイティブのプリペアドステートメントをサポートしていないか、サポートが限られています。この設定を使用すると、PDOは常にプリペアドステートメントをエミュレートするように強制されます(もしTRUE)、またはネイティブのプリペアドステートメントを使用しようとします(もしFALSE)。ドライバが現在のクエリを正常にプリペアドできない場合、常にプリペアドステートメントのエミュレーションにフォールバックします。必要bool型。

  • PDO::MYSQL_ATTR_USE_BUFFERED_QUERY(MySQLで使用可能):バッファリングクエリを使用します。

  • PDO::ATTR_DEFAULT_FETCH_MODE:デフォルトのフェッチモードを設定します。モードの説明は、PDOStatement::fetch()ドキュメントにあります。


戻り値

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。

その他の拡張