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 Drivers for PHP for SQL Server 字符串数组 介绍驱动程序和相关库的版本。 返回带有以下元素的数组：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 Microsoft Drivers for PHP for SQL Server String 指示 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 Microsoft Drivers for PHP for SQL Server 3 个元素的数组 返回当前数据库、SQL Server 版本和 SQL Server 实例。
PDO::ATTR_SERVER_VERSION Microsoft Drivers for PHP for SQL Server String 指示 SQL Server 版本 (Major.Minor.BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES PDO 请参阅 PDO 文档 请参阅 PDO 文档。
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Microsoft Drivers for PHP for SQL Server 1 到 PHP 内存限制。 配置保留客户端游标的结果集的缓冲区大小。

默认值为 10240 KB (10 MB)。

有关客户端游标的详细信息，请参阅游标类型（SQLSRV 驱动程序）。
PDO::SQLSRV_ATTR_DIRECT_QUERY Microsoft Drivers for PHP for SQL Server true

false		 指定直接或已准备的查询执行。 有关详细信息，请参阅 PDO_SQLSRV 驱动程序中的直接语句执行和预定语句执行。
PDO::SQLSRV_ATTR_ENCODING Microsoft Drivers for PHP for SQL Server PDO::SQLSRV_ENCODING_UTF8

PDO::SQLSRV_ENCODING_SYSTEM		 指定驱动程序用于与服务器通信的字符集编码。

默认值为 PDO::SQLSRV_ENCODING_UTF8。
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE Microsoft Drivers for PHP for SQL Server 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 Drivers for PHP for SQL Server 整型 设置查询超时（以秒为单位）。

默认值为 0，这意味着该驱动程序将无限期地等待结果。

不允许使用负数。

PDO 将处理某些预定义的属性，同时它需要驱动程序处理其他属性。 所有自定义属性和连接选项都由驱动程序处理，不受支持的属性或连接选项将返回 null。

已在 Microsoft Drivers for PHP for SQL Server的版本 2.0 中添加了对 PDO 的支持。

示例

此示例显示在更改其值之前和之后的 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