次の方法で共有


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