PDO::setAttribute

Define um atributo PDO pré-definido ou um atributo de driver personalizado.

Syntax

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

Parâmetros

$attribute: O atributo do set. Consulte a secção Observações para uma lista de atributos suportados.

$value: O valor (tipo misto).

Valor de retorno

Retorna verdadeiro em caso de sucesso, caso contrário falso.

Observações

Attribute	Processado por	Valores suportados	Description
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Especifica o caso dos nomes das colunas. PDO::CASE_LOWER causa nomes de colunas em minúsculas. PDO::CASE_NATURAL (o predefinido) mostra os nomes das colunas conforme devolvidos pela base de dados. PDO::CASE_UPPER faz com que os nomes das colunas fiquem em maiúsculas. Este 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::P ARAM_STR_CHAR PDO::P ARAM_STR_NATL	Para mais informações, veja os exemplos em PDO::quote.
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Especifica como o driver reporta falhas. PDO::ERRMODE_SILENT (o padrão) define os códigos de erro e a informação. PDO::ERRMODE_WARNING levanta E_WARNING. PDO::ERRMODE_EXCEPTION faz com que seja lançada uma exceção. Este atributo pode ser definido usando PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Consulte a documentação do PDO.	Especifica como os nulos devem ser devolvidos. PDO::NULL_NATURAL não faz conversão. PDO::NULL_EMPTY_STRING converte uma cadeia vazia em nula. PDO::NULL_TO_STRING converte null numa cadeia vazia.
PDO::ATTR_STATEMENT_CLASS	PDO	Consulte a documentação do PDO.	Define a classe de instrução fornecida pelo utilizador derivada do PDOStatement. Requer `array(string classname, array(mixed constructor_args))`. Para mais informações, consulte a documentação do PDO.
PDO::ATTR_STRINGIFY_FETCHES	PDO	verdadeiro ou falso	Converte valores numéricos em cadeias 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 PHP.	Define o tamanho do buffer que contém o conjunto de resultados ao usar um cursor do lado do cliente. O valor padrão é 10240 KB, se não for especificado no ficheiro php.ini. Números zero e negativos não são permitidos. Para mais informações sobre consultas que criam um cursor do lado do cliente, consulte Tipos de Cursor (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DECIMAL_PLACES	Drivers da Microsoft para PHP para SQL Server	Inteiro entre 0 e 4 (inclusive)	Especifica o número de casas decimais ao formatar valores de moeda buscados. Qualquer valor negativo inteiro ou maior que 4 será ignorado. Esta opção só funciona quando PDO::SQLSRV_ATTR_FORMAT_DECIMALS é verdadeira. Esta opção pode também ser definida ao nível da instrução. Se sim, então a opção de nível de instrução sobrepõe-se a esta. Para mais informações, consulte Formatação de Cadeias Decimais e Valores de Dinheiro (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DIRECT_QUERY	Drivers da Microsoft para PHP para SQL Server	verdadeiro ou falso	Especifica a execução direta ou preparada da consulta. Para mais informações, consulte Execução Direta de Instruções e Execução de Instruções Preparadas 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 comunicar com o servidor. PDO::SQLSRV_ENCODING_BINARY não é suportado. O padrão é PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE	Drivers da Microsoft para PHP para SQL Server	verdadeiro ou falso	Especifica se deve recuperar os tipos de data e hora como objetos PHP DateTime . Se forem deixados falsos, o comportamento padrão é devolvê-los como strings. Esta opção pode também ser definida ao nível da instrução. Se sim, então a opção de nível de instrução sobrepõe-se a esta. Para mais informações, veja Como: Recuperar Tipos de Data e Hora como Objetos PHP DateTime usando o PDO_SQLSRV Driver.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	Drivers da Microsoft para PHP para SQL Server	verdadeiro ou falso	Trata de buscas numéricas a partir de colunas com tipos numéricos SQL (bit, inteiro, smallint, tinyint, float ou real). Quando a flag de opção de ligação ATTR_STRINGIFY_FETCHES está ativada, o valor de retorno é uma string mesmo quando SQLSRV_ATTR_FETCHES_NUMERIC_TYPE está ativada. Quando o tipo PDO devolvido na coluna de ligação está PDO_PARAM_INT, o valor de retorno de uma coluna inteira é um int, mesmo que SQLSRV_ATTR_FETCHES_NUMERIC_TYPE esteja desligado.
PDO::SQLSRV_ATTR_FORMAT_DECIMALS	Drivers da Microsoft para PHP para SQL Server	verdadeiro ou falso	Especifica se deve adicionar zeros à esquerda às cadeias decimais quando apropriado. Se ativada, esta opção ativa a opção PDO::SQLSRV_ATTR_DECIMAL_PLACES para formatar os tipos de dinheiro. Se for deixado falso, utiliza-se o comportamento padrão de devolver precisão exata e omitir os zeros iniciais para valores inferiores a 1. Esta opção pode também ser definida ao nível da instrução. Se sim, então a opção de nível de instrução sobrepõe-se a esta. Para mais informações, consulte Formatação de Cadeias Decimais e Valores de Dinheiro (PDO_SQLSRV Driver).
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 condutor espera indefinidamente pelos resultados. Não são permitidos números negativos.

O PDO processa alguns dos atributos predefinidos e exige que o driver processe outros. Todos os atributos personalizados e opções de ligação são processados pelo driver. Um atributo, opção de ligação ou valor não suportado não suportado é reportado de acordo com a definição de PDO::ATTR_ERRMODE.

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

Example

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

Comentários

Esta página foi útil?

Last updated on 2026-08-24