共用方式為


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 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 字串陣列 描述驅動程式和相關程式庫的版本。 傳回具有下列元素的陣列:ODBC 版本 (MajorVer.MinorVer)、SQL Server Native Client DLL 名稱和版本、Microsoft Drivers for PHP for SQL Server 版本 (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 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 字串 指出 Microsoft Drivers for PHP for SQL Server 版本 (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 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 3 個元素的陣列 傳回目前的資料庫、SQL Server 版本和 SQL Server 執行個體。
PDO::ATTR_SERVER_VERSION 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 String 指出 SQL Server 版本 (Major.Minor.BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES PDO 請參閱 PDO 文件。 請參閱 PDO 文件。
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 1 到 PHP 記憶體限制。 設定將保留用戶端資料指標結果集的緩衝區大小。

預設值為 10,240 KB (10 MB)。

如需用戶端資料指標的詳細資訊,請參閱資料指標類型 (SQLSRV 驅動程式)
PDO::SQLSRV_ATTR_DIRECT_QUERY 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 true

false
指定直接或備妥的查詢執行。 如需詳細資訊,請參閱 PDO_SQLSRV 驅動程式中的直接陳述式執行和已備妥的陳述式執行
PDO::SQLSRV_ATTR_ENCODING 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 PDO::SQLSRV_ENCODING_UTF8

PDO::SQLSRV_ENCODING_SYSTEM
指定驅動程式用來與伺服器通訊的字元集編碼。

預設值為 PDO::SQLSRV_ENCODING_UTF8。
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 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 用於 SQL Server 之 PHP 的 Microsoft 驅動程式 整數 設定查詢逾時 (以秒為單位)。

預設值為 0,表示驅動程式將會無限期地等候結果。

不允許使用負數。

PDO 會處理一些預先定義的屬性,然而需要驅動程式才能處理其他屬性。 驅動程式會處理所有的自訂屬性和連線選項,而不支援的屬性或連線選項會傳回 Null。

PDO 支援已新增至 Microsoft Drivers for PHP for SQL Server 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