PDO::getAttribute

Descarregar o driver PHP

Recupera o valor de um atributo PDO ou driver predefinido.

Syntax

  
mixed PDO::getAttribute ( $attribute )

Parâmetros

$attribute: Um dos atributos apoiados. Consulte a secção de Observações para a lista de atributos suportados.

Valor de retorno

Em caso de sucesso, devolve o valor de uma opção de ligação, atributo PDO pré-definido ou atributo de driver personalizado. Em caso de falha, devolve o valor nulo.

Observações

A tabela seguinte contém a lista de atributos suportados.

Attribute Processado por Valores suportados Description
PDO::ATTR_CASE PDO PDO::CASE_LOWER

PDO::CASE_NATURAL

PDO::CASE_UPPER		 Especifica se os nomes das colunas devem estar num caso específico. PDO::CASE_LOWER força nomes de colunas minúsculas, PDO::CASE_NATURAL deixa o nome da coluna devolvido pela base de dados, e PDO::CASE_UPPER força os nomes das colunas a maiúsculas.

O padrão é PDO::CASE_NATURAL.

Este atributo também pode ser definido usando PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION Drivers da Microsoft para PHP para SQL Server Matriz de cadeias de caracteres Descreve as versões do driver e das bibliotecas relacionadas. Devolve um array com os seguintes elementos: versão ODBC (MajorVer.MinorVer), nome e versão DLL do SQL Server Native Client, drivers Microsoft para PHP para a versão do SQL Server (MajorVer.MinorVer. Número de Construção. Revisão)
PDO::ATTR_DEFAULT_STR_PARAM PDO PDO::P ARAM_STR_CHAR

PDO::P ARAM_STR_NATL		 Se não estiver definido para PDO::P ARAM_STR_CHAR, PDO::P ARAM_STR_NATL é devolvido.
PDO::ATTR_DRIVER_NAME PDO String Devolve sempre "sqlsrv".
PDO::ATTR_DRIVER_VERSION Drivers da Microsoft para PHP para SQL Server String Indica os drivers da Microsoft para PHP para a versão do SQL Server (MajorVer.MinorVer. Número de Construção. Revisão)
PDO::ATTR_ERRMODE PDO PDO::ERRMODE_SILENT

PDO::ERRMODE_WARNING

PDO::ERRMODE_EXCEPTION		 Especifica como as falhas devem ser tratadas pelo driver.

PDO::ERRMODE_SILENT (o padrão) define os códigos de erro e a informação.

PDO::ERRMODE_WARNING levanta uma E_WARNING.

PDO::ERRMODE_EXCEPTION levanta uma exceção.

Este atributo também pode ser definido usando PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS PDO Consulte a documentação do PDO. Consulte a documentação do PDO.
PDO::ATTR_SERVER_INFO Drivers da Microsoft para PHP para SQL Server Array de 3 elementos Devolve a base de dados atual, a versão do SQL Server e a instância do SQL Server.
PDO::ATTR_SERVER_VERSION Drivers da Microsoft para PHP para SQL Server String Indica a versão do SQL Server (Major.Menor. BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES PDO Consulte a documentação do PDO Consulte a documentação do PDO.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Drivers da Microsoft para PHP para SQL Server 1 para o limite de memória PHP. Configura o tamanho do buffer que contém o conjunto de resultados para um cursor do lado do cliente.

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

Para mais informações sobre cursores do lado do cliente, consulte Tipos de Cursor (Driver SQLSRV).
PDO::SQLSRV_ATTR_DIRECT_QUERY Drivers da Microsoft para PHP para SQL Server verdadeiro

false		 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		 Especifica a codificação do conjunto de caracteres usada pelo driver para comunicar com o servidor.

O padrão é PDO::SQLSRV_ENCODING_UTF8.
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, mesmo quando SQLSRV_ATTR_FETCHES_NUMERIC_TYPE está ativada, o valor de retorno é uma string.

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_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 enquanto exige que o driver trate de outros. Todos os atributos personalizados e opções de ligação são tratados pelo driver, um atributo ou opção de ligação não suportado retorna nulo.

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

Example

Este exemplo mostra o valor do atributo PDO::ATTR_ERRMODE, antes e depois de alterar o seu valor.

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

Conteúdo relacionado

  • Last updated on