ЛИНТЕР

Установить атрибут соединения с БД

Назначение

Установка (изменение) атрибутов соединения с БД.

Синтаксические правила

bool PDO::setAttribute (int attribute, mixed value);

attribute

Идентификатор атрибута.

value

Новое значение устанавливаемого атрибута.

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

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

Допустимые значения:
- PDO::CASE_LOWER – преобразовывать к нижнему регистру;
- PDO::CASE_NATURAL – оставлять имена столбцов как есть;
- PDO::CASE_UPPER – преобразовывать к верхнему регистру.
PDO::ATTR_ERRMODE – управление режимом вывода сообщений.

Допустимые значения:
- PDO::ERRMODE_SILENT – выводить сообщения только об ошибках;
- PDO::ERRMODE_WARNING – выводить предупреждения;
- PDO::ERRMODE_EXCEPTION – выводить сообщения об исключениях.
PDO::ATTR_GENERATE_COL_NAME – управление представлением неименованных столбцов выборки данных (заставляет для пустых имён столбцов автоматически генерировать имя AUTO_GENERATED_NAME). Предназначено для работы в программной среде, которая требует обязательного задания имён столбцов в выборке данных. По умолчанию (или при установке значения 0) автоматическое именование пустых столбцов не выполняется.
PDO::ATTR_ORACLE_NULLS – управление преобразованием NULL-значений и пустых строк.

Допустимые значения:
- PDO::NULL_NATURAL – оставлять значение как есть;
- PDO::NULL_EMPTY_STRING – преобразовывать пустую строку в NULL-значение;
- PDO::NULL_TO_STRING – преобразовывать NULL-значение в пустую строку.
PDO::ATTR_RENAME_DUBBED_COL – управление дубликатами имен столбцов в выборке данных. В случае дублирующихся имён столбцов к имени столбца добавляется постфикс _N, где N – номер дубля. (Первый столбец остаётся со своим именем).

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

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

Допустимые значения:
- true – преобразовывать числовые значения в строковый вид;
- false – оставлять числовые значения как есть.
PDO::ATTR_STATEMENT_CLASS – устанавливает пользовательский класс для выражений, наследуемый от PDOStatement.

Допустимые значения:
- array(string classname, array(mixed ctor_args)) – название класса и массив параметров конструктора.
PDO::ATTR_AUTOCOMMIT – управление autocommit-режимом обработки транзакций.

Допустимые значения:
- 0 – включить autocommit-режим;
- 1 – выключить autocommit-режим.
PDO::ATTR_CURSOR_NAME – устанавливает имя курсора.

Допустимые значения:
- string cursorName – имя курсора.
PDO::ATTR_FETCH_TABLE_NAMES – управление добавлением имени таблицы перед именем столбца.

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

Допустимые значения атрибута:
- true – предварять (через точку) имя столбца (таблицы) именем БД;
- false – не добавлять имя БД к имени столбца (таблицы).
PDO::ATTR_DT_FORMAT – устанавливает формат значений типа «дата-время».

Допустимые значения:
- string newDtFormat – шаблон значений типа «дата-время». Формат шаблона аналогичен формату значений типа «дата-время» СУБД ЛИНТЕР (см. документ «СУБД ЛИНТЕР. Справочник по SQL»).
PDO::ATTR_FETCH_BLOB_AS_DATA – управление представлением извлекаемых BLOB-данных.

Допустимые значения:
- true – представлять BLOB-данные в бинарном виде;
- false – представлять BLOB-данные в текстовом виде.

Описание

Функция устанавливает заданные атрибуты соединения.

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

Результат установки атрибутов:

true – атрибуты соединения установлены;
false – неуспешная попытка установки атрибутов.