PDO::setAttribute

Baixar o driver PHP

Define um atributo de PDO preestabelecido ou um atributo de driver personalizado.

Sintaxe

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

Parâmetros

$attribute: o atributo a ser definido. Consulte a seção Comentários para obter uma lista de atributos com suporte.

$value: o valor (tipo misto).

Valor de retorno

Retorna true se for bem-sucedido; caso contrário, false.

Comentários

Atributo	Processado por	Valores com suporte	Descrição
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Especifica se serão usadas maiúsculas ou minúsculas nos nomes das colunas. PDO::CASE_LOWER faz com que os nomes das colunas sejam escritos em minúsculas. PDO::CASE_NATURAL (o padrão) exibe os nomes das colunas conforme são retornados pelo banco de dados. PDO::CASE_UPPER faz com que os nomes das colunas sejam escritos em maiúsculas. Esse atributo pode ser definido usando PDO::setAttribute.
PDO::ATTR_DEFAULT_FETCH_MODE	PDO	Consulte a documentação do PDO.	Consulte a documentação do PDO.
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::PARAM_STR_CHAR PDO::PARAM_STR_NATL	Para obter mais informações, confira os exemplos em PDO::quote.
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Especifica como o driver relata as falhas. PDO::ERRMODE_SILENT (o padrão) define os códigos e as informações de erro. PDO::ERRMODE_WARNING gera E_WARNING. PDO::ERRMODE_EXCEPTION faz com que uma exceção seja gerada. Esse atributo pode ser definido usando PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Consulte a documentação do PDO.	Especifica como os valores nulos devem ser retornados. PDO::NULL_NATURAL não faz nenhuma conversão. PDO::NULL_EMPTY_STRING converte uma cadeia de caracteres vazia em nulo. PDO::NULL_TO_STRING converte nulo em uma cadeia de caracteres vazia.
PDO::ATTR_STATEMENT_CLASS	PDO	Consulte a documentação do PDO.	Define a classe de instrução que o usuário forneceu derivada de PDOStatement. Requer array(string classname, array(mixed constructor_args)). Veja a documentação do PDO para obter mais informações.
PDO::ATTR_STRINGIFY_FETCHES	PDO	true ou false	Converte valores numéricos em cadeias de caracteres ao recuperar dados.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Drivers da Microsoft para PHP para SQL Server	1 para o limite de memória do PHP.	Define o tamanho do buffer que contém o conjunto de resultados ao usar um cursor do lado do cliente. O padrão é 10.240 KB, se não for especificado no arquivo php.ini. Zero e números negativos não são permitidos. Para obter mais informações sobre as consultas que criam um cursor do lado do cliente, veja Tipos de cursor (Driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_DECIMAL_PLACES	Drivers da Microsoft para PHP para SQL Server	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 instrução. Nesse caso, a opção de nível de instrução substitui essa. Para saber mais, confira Formatação de cadeias de caracteres decimais e valores monetários (driver PDO_SQLSRV) .
PDO::SQLSRV_ATTR_DIRECT_QUERY	Drivers da Microsoft para PHP para SQL Server	true ou false	Especifica a execução direta ou preparada da consulta. Para obter mais informações, consulte Execução de instrução direta e execução de instrução preparada no driver PDO_SQLSRV.
PDO::SQLSRV_ATTR_ENCODING	Drivers da Microsoft para PHP para SQL Server	PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM.	Define a codificação do conjunto de caracteres usada pelo driver para se comunicar com o servidor. Não há suporte para PDO::SQLSRV_ENCODING_BINARY. O padrão é PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE	Drivers da Microsoft para PHP para SQL Server	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 instrução. Nesse caso, a opção de nível de instrução substitui essa. 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	Drivers da Microsoft para PHP para SQL Server	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	Drivers da Microsoft para PHP para SQL Server	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 instrução. Nesse caso, a opção de nível de instrução substitui essa. Para saber mais, confira Formatação de cadeias de caracteres decimais e valores monetários (driver PDO_SQLSRV) .
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Drivers da Microsoft para PHP para SQL Server	Número inteiro	Define o tempo limite da consulta em segundos. O padrão é 0, o que significa que o driver aguardará resultados indefinidamente. Números negativos não são permitidos.

O PDO processa alguns atributos predefinidos e requer que o driver processe outros. Todos os atributos personalizados e opções de conexão são processados pelo driver. Um atributo sem suporte, opção de conexão ou valor sem suporte será relatado de acordo com a configuração de PDO::ATTR_ERRMODE.

O suporte para PDO foi adicionado na versão 2.0 dos Drivers da Microsoft para PHP para SQL Server.

Exemplo

Este exemplo mostra como definir o atributo 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" ) ));  
   }  
?>  

Consulte Também

PDO Class

PDO