Compartir a través de


PDO::getAttribute

Descargar controlador PHP

Recupera el valor de un atributo de controlador o un PDO predefinido.

Sintaxis

  
mixed PDO::getAttribute ( $attribute )  

Parámetros

$attribute: uno de los atributos admitidos. Consulte la sección Comentarios para obtener la lista de atributos admitidos.

Valor devuelto

Si se ejecuta correctamente, devuelve el valor de una opción de conexión, el atributo PDO predefinido o el atributo de controlador personalizado. En caso de error, se devuelve el valor Null.

Observaciones

En la tabla siguiente se incluye la lista de atributos admitidos.

Atributo Procesado mediante Valores admitidos Descripción
PDO::ATTR_CASE PDO PDO::CASE_LOWER

PDO::CASE_NATURAL

PDO::CASE_UPPER
Especifica el uso de mayúsculas y minúsculas en los nombres de columna. PDO::CASE_LOWER obliga a que los nombres de columna usen minúsculas, PDO::CASE_NATURAL deja el nombre de columna que devuelve la base de datos y PDO::CASE_UPPER fuerza que los nombres de columna estén en mayúsculas.

El valor predeterminado es PDO::CASE_NATURAL.

Este atributo también puede establecerse utilizando PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION Controladores de Microsoft para PHP para SQL Server Matriz de cadenas Describe las versiones del controlador y las bibliotecas relacionadas. Devuelve una matriz con los elementos siguientes: la versión de ODBC (MajorVer.MinorVer), el nombre y la versión de la DLL de SQL Server Native Client y la versión de Controladores de Microsoft para PHP para SQL Server (MajorVer.MinorVer.BuildNumber.Revision).
PDO::ATTR_DEFAULT_STR_PARAM PDO PDO::PARAM_STR_CHAR

PDO::PARAM_STR_NATL
Si no se establece en PDO::PARAM_STR_CHAR, se devuelve PDO::PARAM_STR_NATL.
PDO::ATTR_DRIVER_NAME PDO String Siempre devuelve "sqlsrv".
PDO::ATTR_DRIVER_VERSION Controladores de Microsoft para PHP para SQL Server String Indica la versión de Controladores de Microsoft para PHP para SQL Server (MajorVer.MinorVer.BuildNumber.Revision).
PDO::ATTR_ERRMODE PDO PDO::ERRMODE_SILENT

PDO::ERRMODE_WARNING

PDO::ERRMODE_EXCEPTION
Especifica cómo debe controlar los errores el controlador.

PDO::ERRMODE_SILENT (el valor predeterminado) establece la información y los códigos de los errores.

PDO::ERRMODE_WARNING genera una advertencia E_WARNING.

PDO::ERRMODE_EXCEPTION produce una excepción.

Este atributo también puede establecerse utilizando PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS PDO Consulte la documentación de PDO. Consulte la documentación de PDO.
PDO::ATTR_SERVER_INFO Controladores de Microsoft para PHP para SQL Server Matriz de 3 elementos Devuelve la base de datos actual, la versión de SQL Server y la instancia de SQL Server.
PDO::ATTR_SERVER_VERSION Controladores de Microsoft para PHP para SQL Server String Indica la versión de SQL Server (Major.Minor.BuildNumber).
PDO::ATTR_STRINGIFY_FETCHES PDO Consultar la documentación de PDO Consulte la documentación de PDO.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Controladores de Microsoft para PHP para SQL Server 1 para el límite de memoria PHP. Configura el tamaño de búfer que contiene el conjunto de resultados de un cursor de cliente.

El valor predeterminado es 10 240 KB (10 MB).

Para obtener más información sobre los cursores de cliente, vea Tipos de cursor (Controlador SQLSRV).
PDO::SQLSRV_ATTR_DIRECT_QUERY Controladores de Microsoft para PHP para SQL Server true

false
Especifica la ejecución de la consulta directa o preparada. Para obtener más información, vea Direct Statement Execution and Prepared Statement Execution in the PDO_SQLSRV Driver (Ejecución de la instrucción preparada o directa en el controlador PDO_SQLSRV).
PDO::SQLSRV_ATTR_ENCODING Controladores de Microsoft para PHP para SQL Server PDO::SQLSRV_ENCODING_UTF8

PDO::SQLSRV_ENCODING_SYSTEM
Especifica el juego de caracteres que utiliza el controlador para comunicarse con el servidor.

El valor predeterminado es PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE Controladores de Microsoft para PHP para SQL Server true o false Controla los resultados numéricos de las columnas con los tipos SQL numéricos (bit, integer, smallint, tinyint, float o real).

Cuando la marca de la opción de conexión ATTR_STRINGIFY_FETCHES está activada, el valor devuelto es una cadena, incluso cuando SQLSRV_ATTR_FETCHES_NUMERIC_TYPE está activado.

Cuando el tipo devuelto de PDO en la columna de enlace es PDO_PARAM_INT, el valor devuelto de una columna de enteros es un valor int aunque SQLSRV_ATTR_FETCHES_NUMERIC_TYPE esté desactivado.
PDO::SQLSRV_ATTR_QUERY_TIMEOUT Controladores de Microsoft para PHP para SQL Server Entero Establece el tiempo de espera de consulta en segundos.

El valor predeterminado es 0, lo que significa que el controlador esperará indefinidamente para obtener los resultados.

No se permiten números negativos.

PDO procesa algunos de los atributos predefinidos, aunque requiere que el controlador controle otros. Todas las opciones de conexión y los atributos personalizados se administran mediante el controlador; las opciones de conexión o los atributos no admitidos devuelven el valor NULL.

En la versión 2.0 de los Controladores de Microsoft para PHP para SQL Server, se agregó compatibilidad con PDO.

Ejemplo

En este ejemplo se muestra el valor del atributo PDO::ATTR_ERRMODE antes y después de cambiar su 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 ));  
?>  

Consulte también

Clase PDO

PDO