« PDOStatement::rowCount
PDOStatement::setFetchMode »

PDOStatement::setAttribute

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDOStatement::setAttribute — 文の属性を設定する

説明

public function PDOStatement::setAttribute(int $attribute, mixed $value): bool

文の属性を設定します。現時点で共通の属性は存在しませんが、 ドライバ固有の属性のみ存在します。

  • PDO::ATTR_CURSOR_NAME (Firebird と ODBC 固有): UPDATE ... WHERE CURRENT OF に対するカーソル名を取得する

ドライバ固有の属性は、 他のドライバでは使っては いけない ことに注意して下さい。

パラメータ

attribute

変更する属性。

value

attribute に設定する値。 属性によっては、特定の型が必要かもしれません。

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

PHP 8.5.0 以降、Firebird ドライバを使用している場合、 PDO::ATTR_CURSOR_NAME で設定したカーソル名が長すぎると ValueError がスローされます。

変更履歴

バージョン 説明
8.5.0 Firebird ドライバを使用している場合、 PDO::ATTR_CURSOR_NAME で設定したカーソル名が長すぎると ValueError がスローされるようになりました。

参考

関連キーワード:
属性   PDOStatement   ドライバ   setAttribute   attribute   固有   Firebird   カーソル   ValueError   getAttribute   rowCount   setFetchMode   mixed   現時点   共通   特定   成功   履歴   参考   データベース   接続
関連する関数・ページ:
pdostatement.getattribute   pdo.setattribute   pdo.getattribute   book.pdo   ref.pdo-sqlsrv   pdo.constants