PDO::getAttribute

Artículo
06/02/2023

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