Получить значение атрибута соединения с БД

Назначение

Получение значения атрибута соединения с БД.

Синтаксические правила
 
mixed PDO::getAttribute (int attribute);
attribute

Идентификатор запрашиваемого атрибута.

Кроме атрибутов, перечисленных в пункте «Установить атрибут соединения с БД», дополнительно может быть запрошена информация о следующих атрибутах:

  1. PDO::ATTR_DRIVER_NAME – название драйвера, используемого для доступа из клиентских PHP-приложений к СУБД ЛИНТЕР (возвращается значение linter).

  2. PDO::ATTR_CURSOR – тип курсора.

    Возможные значения:

    • PDO::CURSOR_SCROLL – скролируемый курсор (перемещение по выборке вперед/назад).

  3. PDO::ATTR_SERVER_VERSION – версия сервера БД.

    Возможные значения:

    • string ServerVersion – строка, содержащая номер версии, релиза, сборки СУБД ЛИНТЕР.

  4. PDO::ATTR_CONNECTION_STATUS – статус соединения.

    Возможные значения:

    • 0 – соединение с БД не установлено;

    • 1 – соединение с БД установлено.

  5. PDO::ATTR_SERVER_INFO – информация о сервере БД в виде ассоциированного массива, содержащего параметры соединения (см. пункт «Получить параметры соединения с БД» в разделе «Linter PHP-интерфейс»).

  6. PDO::ATTR_CLIENT_VERSION – версия используемого драйвера php_pdo_linter.

  7. PDO::ATTR_MAX_COLUMN_LEN – максимальная длина ответа.

  8. PDO::ATTR_RENAME_DUBBED_COL – управление дубликатами имен столбцов в выборке данных. В случае дублирующихся имён столбцов к имени столбца добавляется постфикс _N, где N – номер дубля. (Первый столбец остаётся со своим именем).

    По умолчанию (или при установке значения 0 (FALSE)) дубликаты имен столбцов остаются неизменными.

    Однако в комбинации PDO::FETCH_LAZY + PDO::ATTR_RENAME_DUBBED_COL = FALSE переименование столбцов с одинаковыми именами будет выполняться.

  9. PDO::ATTR_GENERATE_COL_NAME – управление представлением неименованных столбцов выборки данных (заставляет для пустых имён столбцов автоматически генерировать имя AUTO_GENERATED_NAME). Предназначено для работы в программной среде, которая требует обязательного задания имён столбцов в выборке данных. По умолчанию (или при установке значения 0) автоматическое именование пустых столбцов не выполняется.

  10. PDO::ATTR_CURSOR_NAME – устанавливает имя курсора.

    Допустимые значения:

    • string cursorName – имя курсора.

  11. PDO::ATTR_AUTOCOMMIT – управление autocommit-режимом обработки транзакций.

    Допустимые значения:

    • 0 – включить autocommit-режим;

    • 1 – выключить autocommit-режим.

  12. PDO::ATTR_STATEMENT_CLASS – устанавливает пользовательский класс для выражений, наследуемый от PDOStatement.

    Допустимые значения:

    • array(string classname, array(mixed ctor_args)) – название класса и массив параметров конструктора.

  13. PDO::ATTR_ERRMODE – управление режимом вывода сообщений.

    Допустимые значения:

    • PDO::ERRMODE_SILENT – выводить сообщения только об ошибках;

    • PDO::ERRMODE_WARNING – выводить предупреждения;

    • PDO::ERRMODE_EXCEPTION – выводить сообщения об исключениях.

  14. PDO::ATTR_DT_FORMAT – устанавливает формат значений типа «дата-время».

    Допустимые значения:

  15. PDO::ATTR_FETCH_CATALOG_NAMES – управление добавлением имени БД перед именем столбца (таблицы).

    Допустимые значения атрибута:

    • true – предварять (через точку) имя столбца (таблицы) именем БД;

    • false – не добавлять имя БД к имени столбца (таблицы).

  16. PDO::ATTR_FETCH_TABLE_NAMES – управление добавлением имени таблицы перед именем столбца.

    Допустимые значения:

    • true – предварять (через точку) имя столбца именем таблицы;

    • false – не добавлять имя таблицы к имени столбца.

  17. PDO::ATTR_STRINGIFY_FETCHES – управление преобразованием числовых значений.

    Допустимые значения:

    • true – преобразовывать числовые значения в строковый вид;

    • false – оставлять числовые значения как есть.

  18. PDO::ATTR_ORACLE_NULLS – управление преобразованием NULL-значений и пустых строк.

    Допустимые значения:

    • PDO::NULL_NATURAL – оставлять значение как есть;

    • PDO::NULL_EMPTY_STRING – преобразовывать пустую строку в NULL-значение;

    • PDO::NULL_TO_STRING – преобразовывать NULL-значение в пустую строку.

  19. PDO::ATTR_CASE – управление преобразованием имен столбцов.

    Допустимые значения:

    • PDO::CASE_LOWER – преобразовывать к нижнему регистру;

    • PDO::CASE_NATURAL – оставлять имена столбцов как есть;

    • PDO::CASE_UPPER – преобразовывать к верхнему регистру.

Описание

Функция предоставляет текущее значение запрошенного атрибута соединения.

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

Результат выполнения функции:

  • значение запрошенного атрибута (удачное завершение);

  • NULL-значение – неудачное завершение.