PDO::getAttribute

Статья
10/16/2024

Извлекает значение предварительно заданного атрибута PDO или атрибута драйвера.

Синтаксис

  
mixed PDO::getAttribute ( $attribute )

Параметры

$attribute: один из поддерживаемых атрибутов. Список поддерживаемых атрибутов см. в разделе "Примечания".

Возвращаемое значение

В случае успешного выполнения возвращает значение параметра соединения, предварительно заданного атрибута PDO или настраиваемого атрибута драйвера. В случае неудачи возвращает значение NULL.

Замечания

Следующая таблица содержит список поддерживаемых атрибутов.

Атрибут	Обрабатывается	Поддерживаемые значения	Description
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Указывает, должны ли имена столбцов иметь определенный регистр. PDO::CASE_LOWER принудительно отображает имена столбцов в нижнем регистре, PDO::CASE_NATURA оставляет имена столбцов в том виде, в котором они возвращаются из базы данных, а PDO::CASE_UPPER принудительно отображает имена столбцов в верхнем регистре. Значение по умолчанию — PDO::CASE_NATURAL. Этот атрибут также можно задать с помощью PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION	Драйверы Microsoft SQL Server для PHP	Массив строк	Описывает версии драйвера и связанные с ними библиотеки. Возвращает массив со следующими элементами: версия ODBC (MajorVer).MinorVer), имя и версия библиотеки DLL собственного клиента SQL Server, драйверы Майкрософт для PHP для ВЕРСИИ SQL Server (MajorVer).MinorVer.BuildNumber.Редакция)
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::PARAM_STR_CHAR PDO::PARAM_STR_NATL	Если не задано значение PDO::P ARAM_STR_CHAR, возвращается PDO::P ARAM_STR_NATL.
PDO::ATTR_DRIVER_NAME	PDO	Строка	Всегда возвращает "sqlsrv".
PDO::ATTR_DRIVER_VERSION	Драйверы Microsoft SQL Server для PHP	Строка	Указывает драйверы Майкрософт для PHP для версии SQL Server (MajorVer).MinorVer.BuildNumber.Редакция)
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Указывает способ обработки ошибок драйвером. PDO::ERRMODE_SILENT (используется по умолчанию) задает коды ошибок и сведения об ошибках. PDO::ERRMODE_WARNING вызывает E_WARNING. PDO::ERRMODE_EXCEPTION вызывает исключение. Этот атрибут также можно задать с помощью PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Обратитесь к документации по PDO.	Обратитесь к документации по PDO.
PDO::ATTR_SERVER_INFO	Драйверы Microsoft SQL Server для PHP	Массив из 3 элементов	Возвращает текущую базу данных, версию SQL Server и экземпляр SQL Server.
PDO::ATTR_SERVER_VERSION	Драйверы Microsoft SQL Server для PHP	Строка	Показывает версию SQL Server (основной_номер.дополнительный_номер.номер_сборки)
PDO::ATTR_STRINGIFY_FETCHES	PDO	Обратитесь к документации по PDO.	Обратитесь к документации по PDO.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Драйверы Microsoft SQL Server для PHP	От 1 до предела памяти PHP.	Задает размер буфера, который содержит результирующий набор для клиентского курсора. Значение по умолчанию — 10 240 КБ (10 МБ). Дополнительные сведения о клиентских курсорах см. в статье Типы курсоров (драйвер SQLSRV).
PDO::SQLSRV_ATTR_DIRECT_QUERY	Драйверы Microsoft SQL Server для PHP	true false	Задает выполнение прямого или подготовленного запроса. Дополнительные сведения см. в статье Выполнение прямых и подготовленных инструкций в драйвере PDO_SQLSRV.
PDO::SQLSRV_ATTR_ENCODING	Драйверы Microsoft SQL Server для PHP	PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM	Указывает кодировку, используемую драйвером для обмена данными с сервером. По умолчанию используется PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	Драйверы Microsoft SQL Server для PHP	true или false	Обрабатывает выборку числовых значений из столбцов с числовыми типами SQL (bit, integer, smallint, tinyint, float или real). Если включен флаг параметра подключения ATTR_STRINGIFY_FETCHES, возвращаемое значение является строкой даже при включении SQLSRV_ATTR_FETCHES_NUMERIC_TYPE. Если возвращаемый тип PDO в столбце привязки представляет PDO_PARAM_INT, возвращаемое значение из столбца с целочисленными значениями имеет тип int даже при отключении SQLSRV_ATTR_FETCHES_NUMERIC_TYPE.
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Драйверы Microsoft SQL Server для PHP	integer	Задает время ожидания выполнения запроса в секундах. По умолчанию используется значение 0, то есть драйвер ожидает результаты бесконечно долго. Отрицательные значения не допускаются.

PDO обрабатывает некоторые предопределенные атрибуты, оставляя обработку остальных драйверу. Все настраиваемые атрибуты и параметры соединения обрабатываются драйвером, а неподдерживаемые атрибуты и параметры соединения возвращают значение NULL.

Добавлена поддержка PDO версии 2.0 драйверов Майкрософт для PHP для SQL Server.

Пример

Этот пример показывает значение атрибута 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" ) ));  
}  
  
// An example using PDO::ATTR_CLIENT_VERSION  
print_r($conn->getAttribute( PDO::ATTR_CLIENT_VERSION ));  
?>

См. также

Класс PDO

PDO

Поделиться через