PDOStatement::setAttribute
设置预定义的 PDO 属性或自定义驱动程序属性的属性值。
语法
bool PDOStatement::setAttribute ($attribute, $value );
参数
$attribute：一个整数，PDO::ATTR_* 或 PDO::SQLSRV_ATTR_* 常量之一。 请参阅可用属性列表的“备注”部分。
$value：为指定的 $attribute 设置的（混合）值。
返回值
如果成功，则为 TRUE；否则为 FALSE。
注解
下表包含可用属性列表：
| 属性 | 值 | 说明 |
|---|---|---|
| PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE | 1 到 PHP 内存限制。 | 配置保留客户端游标的结果集的缓冲区大小。 默认值为 10240 KB (10 MB)。 有关客户端游标的详细信息，请参阅游标类型（PDO_SQLSRV 驱动程序）。 |
| PDO::SQLSRV_ATTR_DATA_CLASSIFICATION | True 或 False | 指定在调用 PDOStatement::getColumnMeta 时是否检索数据分类元数据。 默认值为 false。 |
| PDO::SQLSRV_ATTR_DECIMAL_PLACES | 介于 0 和 4 之间（含 0 和 4）的整数 | 指定设置提取的 Money 值格式时的小数位数。 将忽略任何负整数或大于 4 的值。 此选项仅在 PDO::SQLSRV_ATTR_FORMAT_DECIMALS 为 true 时适用。 还可以在连接级别设置此选项。 如果是这样，此选项将覆盖连接级别选项。 有关详细信息，请参阅设置十进制字符串和 Money 值格式（PDO_SQLSRV 驱动程序）。 |
| PDO::SQLSRV_ATTR_ENCODING | Integer PDO::SQLSRV_ENCODING_UTF8（默认值） PDO::SQLSRV_ENCODING_SYSTEM PDO::SQLSRV_ENCODING_BINARY |
设置驱动程序用于与服务器通信的字符集编码。 |
| PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE | True 或 False | 指定是否以 PHP DateTime 对象形式检索日期和时间类型。 如果保留 false，则默认行为是将它们作为字符串返回。 还可以在连接级别设置此选项。 如果是这样，此选项将覆盖连接级别选项。 有关详细信息，请参阅操作说明：使用 PDO_SQLSRV 驱动程序检索日期和时间类型作为 PHP Datetime 对象。 |
| PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE | 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_FORMAT_DECIMALS | True 或 False | 指定是否在合适时向十进制字符串添加前导零。 如已设置，此选项将启用用于设置 Money 类型格式的 PDO::SQLSRV_ATTR_DECIMAL_PLACES 选项。 如果保留 false，使用的默认行为是返回精确的精度，并为小于 1 的值省略前导零。 还可以在连接级别设置此选项。 如果是这样，此选项将覆盖连接级别选项。 有关详细信息，请参阅设置十进制字符串和 Money 值格式（PDO_SQLSRV 驱动程序）。 |
| PDO::SQLSRV_ATTR_QUERY_TIMEOUT | Integer | 设置查询超时（以秒为单位）。 默认情况下，驱动程序将无限期等待结果。 不允许使用负数。 0 表示没有超时。 |
示例
<?php
$database = "AdventureWorks";
$server = "(local)";
$conn = new PDO( "sqlsrv:server=$server ; Database = $database", "", "", array('MultipleActiveResultSets'=>false ) );
$stmt = $conn->prepare('SELECT * FROM Person.ContactType');
echo $stmt->getAttribute( constant( "PDO::ATTR_CURSOR" ) );
echo "\n";
$stmt->setAttribute(PDO::SQLSRV_ATTR_QUERY_TIMEOUT, 2);
echo $stmt->getAttribute( constant( "PDO::SQLSRV_ATTR_QUERY_TIMEOUT" ) );
?>