PDO::getAttribute

PHP ドライバーのダウンロード

定義済み PDO またはドライバーの属性の値を取得します。

構文

  
mixed PDO::getAttribute ( $attribute )  

パラメーター

$attribute: サポートされる属性のいずれか。 サポートされる属性の一覧については、「解説」セクションを参照してください。

戻り値

成功した場合、接続オプション、定義済み PDO 属性、またはカスタム ドライバー属性の値を返します。 エラーが発生した場合は null を返します。

解説

次の表に、サポートされる属性の一覧を示します。

属性	処理を行った機能	サポートされている値	説明
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	列名に必要な大文字/小文字の使い分けを指定します。 PDO::CASE_LOWER は、列名を強制的に小文字にします。PDO::CASE_NATURAL は、列名をデータベースによって返されたままの状態にします。PDO::CASE_UPPER は、列名を強制的に大文字にします。 既定値は、PDO::CASE_NATURAL です。 この属性は、PDO::setAttribute を使用して設定することもできます。
PDO::ATTR_CLIENT_VERSION	Microsoft SQL Server 用 Drivers for PHP	文字列の配列	ドライバーおよび関連するライブラリのバージョンを記述します。 次の要素を含む配列を返します。ODBC のバージョン (MajorVer.MinorVer)、SQL Server Native Client DLL の名前とバージョン、Microsoft SQL Server 用 Drivers for PHP バージョン (MajorVer.MinorVer.BuildNumber.Revision)
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::PARAM_STR_CHAR PDO::PARAM_STR_NATL	PDO::PARAM_STR_CHAR に設定されていない場合、PDO::PARAM_STR_NATL が返されます。
PDO::ATTR_DRIVER_NAME	PDO	String	常に "sqlsrv" を返します。
PDO::ATTR_DRIVER_VERSION	Microsoft SQL Server 用 Drivers for PHP	String	Microsoft SQL Server 用 Drivers for PHP のバージョンを示します (MajorVer.MinorVer.BuildNumber.Revision)
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	ドライバーがエラーを処理する方法を指定します。 PDO::ERRMODE_SILENT (既定値) は、エラー コードと情報を設定します。 PDO::ERRMODE_WARNING は、E_WARNING を生成します。 PDO::ERRMODE_EXCEPTION は、例外を生成します。 この属性は、PDO::setAttribute を使用して設定することもできます。
PDO::ATTR_ORACLE_NULLS	PDO	PDO のドキュメントを参照してください。	PDO のドキュメントを参照してください。
PDO::ATTR_SERVER_INFO	Microsoft SQL Server 用 Drivers for PHP	3 つの要素の配列	現在のデータベース、SQL Server のバージョン、および SQL Server のインスタンスを返します。
PDO::ATTR_SERVER_VERSION	Microsoft SQL Server 用 Drivers for PHP	String	SQL Server のバージョンを示します (Major.Minor.BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES	PDO	PDO のドキュメントを参照してください。	PDO のドキュメントを参照してください。
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Microsoft SQL Server 用 Drivers for PHP	PHP メモリの制限に 1。	クライアント側カーソルの結果セットを保持するバッファーのサイズを設定します。 既定値は 10,240 KB (10 MB) です。 クライアント側カーソルの詳細については、「カーソルの種類 (SQLSRV ドライバー)」を参照してください。
PDO::SQLSRV_ATTR_DIRECT_QUERY	Microsoft SQL Server 用 Drivers for PHP	true false	クエリの直接実行または準備された実行を指定します。 詳細については、「 Direct Statement Execution and Prepared Statement Execution in the PDO_SQLSRV Driver」 (PDO_SQLSRV ドライバーでの直接ステートメント実行と準備されたステートメントの実行) を参照してください。
PDO::SQLSRV_ATTR_ENCODING	Microsoft SQL Server 用 Drivers for PHP	PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM	ドライバーがサーバーとの通信に使用する文字セット エンコーディングを指定します。 既定値は PDO::SQLSRV_ENCODING_UTF8 です。
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	Microsoft SQL Server 用 Drivers for PHP	true または false	数値の SQL 型 (bit、integer、smallint、tinyint、float、または real) の列からの数値フェッチを処理します。 接続オプション フラグ ATTR_STRINGIFY_FETCHES がオンの場合、SQLSRV_ATTR_FETCHES_NUMERIC_TYPE がオンであっても、戻り値は文字列となります。 バインド列の戻された PDO 型が PDO_PARAM_INT の場合、整数列からの戻り値は、SQLSRV_ATTR_FETCHES_NUMERIC_TYPE がオフであっても int となります。
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Microsoft SQL Server 用 Drivers for PHP	整数	クエリのタイムアウト (秒単位) を設定します。 既定値は 0 であり、ドライバーは結果をいつまでも待ちます。 負の数値は許可できません。

一部の定義済み属性は PDO で処理されますが、他の属性はドライバーで処理する必要があります。 すべてのカスタム属性および接続オプションはドライバーによって処理され、サポートされていない属性または接続オプションは null を返します。

PDO のサポートは Microsoft SQL Server 用 Drivers for PHPのバージョン 2.0 で追加されました。

例

次の例では、値を変更する前と後の PDO::ATTR_ERRMODE 属性の値を示します。

<?php  
$database = "AdventureWorks";  
$conn = new PDO( "sqlsrv:server=(local) ; Database = $database", "", "");  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
// An example using PDO::ATTR_CLIENT_VERSION  
print_r($conn->getAttribute( PDO::ATTR_CLIENT_VERSION ));  
?>  

参照

PDO クラス

PDO