Partilhar via


PDOStatement::setAttribute

Baixar o driver PHP

Define um valor de atributo, seja um atributo de PDO preestabelecido ou um atributo de driver personalizado.

Sintaxe

bool PDOStatement::setAttribute ($attribute, $value );  

Parâmetros

$attribute: um inteiro, uma das constantes PDO::ATTR_* ou PDO::SQLSRV_ATTR_*. Consulte a seção Comentários para obter uma lista de atributos disponíveis.

$value: o valor (misto) a ser definido para o $attribute especificado.

Valor de retorno

TRUE se for bem-sucedido; caso contrário, FALSE.

Comentários

A tabela a seguir contém a lista dos atributos disponíveis:

Atributo Valores Descrição
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE 1 para o limite de memória do PHP. Configura o tamanho do buffer que contém o conjunto de resultados de um cursor do lado do cliente.

O padrão é 10.240 KB (10 MB).

Para obter mais informações sobre os cursores do lado do cliente, confira Tipos de cursor (Driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_DATA_CLASSIFICATION true ou false Especifica se os metadados de classificação de dados devem ser recuperados ao chamar PDOStatement::getColumnMeta. O padrão é falso.
PDO::SQLSRV_ATTR_DECIMAL_PLACES Um inteiro entre 0 e 4 (inclusive) Especifica o número de casas decimais ao formatar valores monetários buscados.

Qualquer inteiro negativo ou um valor maior que 4 será ignorado.

Esta opção só funciona quando PDO::SQLSRV_ATTR_FORMAT_DECIMALS é verdadeiro.

Esta opção também pode ser definida no nível de conexão. Nesse caso, esta opção substitui a opção de nível de conexão.

Para saber mais, confira Formatação de cadeias de caracteres decimais e valores monetários (driver PDO_SQLSRV) .
PDO::SQLSRV_ATTR_ENCODING Integer

PDO::SQLSRV_ENCODING_UTF8 (padrão)

PDO::SQLSRV_ENCODING_SYSTEM

PDO::SQLSRV_ENCODING_BINARY
Define a codificação do conjunto de caracteres a ser usada pelo driver para se comunicar com o servidor.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE true ou false Especifica quando recuperar tipos de data e hora como objetos de DateTime PHP. Se for deixado como false, o comportamento padrão é retorná-los como cadeias de caracteres.

Esta opção também pode ser definida no nível de conexão. Nesse caso, esta opção substitui a opção de nível de conexão.

Para obter mais informações, confira Como recuperar tipos de data e hora como objetos DateTime PHP usando o driver PDO_SQLSRV.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE true ou false Lida com buscas numéricas de colunas com tipos numéricos do SQL (bit, inteiro, smallint, tinyint, float ou real).

Quando o sinalizador de opção de conexão ATTR_STRINGIFY_FETCHES está ativado, o valor de retorno é uma cadeia de caracteres, mesmo quando SQLSRV_ATTR_FETCHES_NUMERIC_TYPE estiver ativado.

Quando o tipo PDO retornado na coluna de associação for PDO_PARAM_INT, o valor de retorno de uma coluna de números inteiros é int, mesmo se SQLSRV_ATTR_FETCHES_NUMERIC_TYPE estiver desativado.
PDO::SQLSRV_ATTR_FORMAT_DECIMALS true ou false Especifica quando é apropriado adicionar zeros à esquerda em cadeias de caracteres decimais. Se definida, essa opção habilita a opção PDO::SQLSRV_ATTR_DECIMAL_PLACES para formatação de tipos de moedas. Se for deixado como false, será usado o comportamento padrão de retornar a precisão exata e omitir zeros para valores menores do que 1.

Esta opção também pode ser definida no nível de conexão. Nesse caso, esta opção substitui a opção de nível de conexão.

Para saber mais, confira Formatação de cadeias de caracteres decimais e valores monetários (driver PDO_SQLSRV) .
PDO::SQLSRV_ATTR_QUERY_TIMEOUT Integer Define o tempo limite da consulta em segundos.

Por padrão, o driver aguardará resultados indefinidamente. Números negativos não são permitidos.

0 significa “sem tempo limite”.

Exemplo

<?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" ) );  
?>  

Consulte Também

PDOStatement Class

PDO