Получить значение атрибута соединения с БД
Назначение
Получение значения атрибута соединения с БД.
Синтаксические правила
mixed PDO::getAttribute (int attribute);
attribute
-
Идентификатор запрашиваемого атрибута.
Кроме атрибутов, перечисленных в пункте «Установить атрибут соединения с БД», дополнительно может быть запрошена информация о следующих атрибутах:
-
PDO::ATTR_DRIVER_NAME
– название драйвера, используемого для доступа из клиентских PHP-приложений к СУБД ЛИНТЕР (возвращается значение linter). -
PDO::ATTR_CURSOR
– тип курсора.Возможные значения:
-
PDO::CURSOR_SCROLL
– скролируемый курсор (перемещение по выборке вперед/назад).
-
-
PDO::ATTR_SERVER_VERSION
– версия сервера БД.Возможные значения:
-
string ServerVersion
– строка, содержащая номер версии, релиза, сборки СУБД ЛИНТЕР.
-
-
PDO::ATTR_CONNECTION_STATUS
– статус соединения.Возможные значения:
-
0 – соединение с БД не установлено;
-
1 – соединение с БД установлено.
-
-
PDO::ATTR_SERVER_INFO
– информация о сервере БД в виде ассоциированного массива, содержащего параметры соединения (см. пункт «Получить параметры соединения с БД» в разделе «Linter PHP-интерфейс»). -
PDO::ATTR_CLIENT_VERSION
– версия используемого драйвераphp_pdo_linter
. -
PDO::ATTR_MAX_COLUMN_LEN
– максимальная длина ответа. -
PDO::ATTR_RENAME_DUBBED_COL
– управление дубликатами имен столбцов в выборке данных. В случае дублирующихся имён столбцов к имени столбца добавляется постфикс _N, где N – номер дубля. (Первый столбец остаётся со своим именем).По умолчанию (или при установке значения 0 (FALSE)) дубликаты имен столбцов остаются неизменными.
Однако в комбинации PDO::FETCH_LAZY + PDO::ATTR_RENAME_DUBBED_COL = FALSE переименование столбцов с одинаковыми именами будет выполняться.
-
PDO::ATTR_GENERATE_COL_NAME
– управление представлением неименованных столбцов выборки данных (заставляет для пустых имён столбцов автоматически генерировать имя AUTO_GENERATED_NAME). Предназначено для работы в программной среде, которая требует обязательного задания имён столбцов в выборке данных. По умолчанию (или при установке значения 0) автоматическое именование пустых столбцов не выполняется. -
PDO::ATTR_CURSOR_NAME
– устанавливает имя курсора.Допустимые значения:
-
string cursorName
– имя курсора.
-
-
PDO::ATTR_AUTOCOMMIT
– управление autocommit-режимом обработки транзакций.Допустимые значения:
-
0 – включить autocommit-режим;
-
1 – выключить autocommit-режим.
-
-
PDO::ATTR_STATEMENT_CLASS
– устанавливает пользовательский класс для выражений, наследуемый от PDOStatement.Допустимые значения:
-
array(string classname, array(mixed ctor_args))
– название класса и массив параметров конструктора.
-
-
PDO::ATTR_ERRMODE
– управление режимом вывода сообщений.Допустимые значения:
-
PDO::ERRMODE_SILENT
– выводить сообщения только об ошибках; -
PDO::ERRMODE_WARNING
– выводить предупреждения; -
PDO::ERRMODE_EXCEPTION
– выводить сообщения об исключениях.
-
-
PDO::ATTR_DT_FORMAT
– устанавливает формат значений типа «дата-время».Допустимые значения:
-
string newDtFormat
– шаблон значений типа «дата-время». Формат шаблона см. в документе «СУБД ЛИНТЕР. Справочник по SQL».
-
-
PDO::ATTR_FETCH_CATALOG_NAMES
– управление добавлением имени БД перед именем столбца (таблицы).Допустимые значения атрибута:
-
true
– предварять (через точку) имя столбца (таблицы) именем БД; -
false
– не добавлять имя БД к имени столбца (таблицы).
-
-
PDO::ATTR_FETCH_TABLE_NAMES
– управление добавлением имени таблицы перед именем столбца.Допустимые значения:
-
true
– предварять (через точку) имя столбца именем таблицы; -
false
– не добавлять имя таблицы к имени столбца.
-
-
PDO::ATTR_STRINGIFY_FETCHES
– управление преобразованием числовых значений.Допустимые значения:
-
true
– преобразовывать числовые значения в строковый вид; -
false
– оставлять числовые значения как есть.
-
-
PDO::ATTR_ORACLE_NULLS
– управление преобразованием NULL-значений и пустых строк.Допустимые значения:
-
PDO::NULL_NATURAL
– оставлять значение как есть; -
PDO::NULL_EMPTY_STRING
– преобразовывать пустую строку в NULL-значение; -
PDO::NULL_TO_STRING
– преобразовывать NULL-значение в пустую строку.
-
-
PDO::ATTR_CASE
– управление преобразованием имен столбцов.Допустимые значения:
-
PDO::CASE_LOWER
– преобразовывать к нижнему регистру; -
PDO::CASE_NATURAL
– оставлять имена столбцов как есть; -
PDO::CASE_UPPER
– преобразовывать к верхнему регистру.
-
-
Описание
Функция предоставляет текущее значение запрошенного атрибута соединения.
Возвращаемое значение
Результат выполнения функции:
-
значение запрошенного атрибута (удачное завершение);
-
NULL-значение – неудачное завершение.