PDO::setAttribute

(PHP 5 >= 5.1.0, PHP 7, PECL pdo >= 0.1.0)

PDO::setAttribute Установка атрибута

Описание

public PDO::setAttribute ( int $attribute , mixed $value ) : bool

Устанавливает атрибут объекту PDO. Некоторые основные атрибуты приведены ниже; отдельные драйверы могут имеет свои дополнительные атрибуты.

  • PDO::ATTR_CASE: Приводить имена столбцов к заданному регистру.

    • PDO::CASE_LOWER: Приводить имена столбцов к нижнему регистру.

    • PDO::CASE_NATURAL: Оставлять имена столбцов в том виде, в котором они были возвращены драйвером.

    • PDO::CASE_UPPER: Приводить имена столбцов к верхнему регистру.

  • PDO::ATTR_ERRMODE: Режим сообщений об ошибках.

    • PDO::ERRMODE_SILENT: Только установка кодов ошибок.

    • PDO::ERRMODE_WARNING: Вызывать E_WARNING.

    • PDO::ERRMODE_EXCEPTION: Выбрасывать исключения.

  • PDO::ATTR_ORACLE_NULLS (доступен для всех драйверов, не только для Oracle): Преобразование NULL в пустые строки.

    • PDO::NULL_NATURAL: Без преобразования.

    • PDO::NULL_EMPTY_STRING: Пустые строки преобразовывать в NULL.

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

  • PDO::ATTR_STRINGIFY_FETCHES: Преобразовывать числовые значения в строки во время выборки. Требует значение типа bool.

  • PDO::ATTR_STATEMENT_CLASS: Задает пользовательский класс, производный от PDOStatement. Не может использоваться с объектами PDO, использующими постоянные соединения. Принимает массив array(string classname, array(mixed constructor_args)).

  • PDO::ATTR_TIMEOUT: Задает тайм-аут в секундах. Не все драйверы поддерживают эту опцию. Также назначение этого тайм-аута может отличаться в разных драйверах. Например, sqlite будет ждать это количество времени для получения блокировки на запись. А другие драйверы могут использовать его, как тайм-аут подключения или чтения. Атрибут принимает значение типа int.

  • PDO::ATTR_AUTOCOMMIT (доступен в OCI, Firebird и MySQL): Требуется ли автоматическая фиксация каждого отдельного выражения в запросе.

  • PDO::ATTR_EMULATE_PREPARES Включение или выключение эмуляции подготавливаемых запросов. Некоторые драйверы не поддерживают подготавливаемые запросы, либо их поддержка ограничена. Эта настройка указывает PDO всегда эмулировать подготавливаемые запросы (если TRUE и эмуляция поддерживается драйвером) или пытаться использовать собственные подготавливаемые запросы (если FALSE). Если драйвер не сможет подготовить запрос, эта настройка сбросится в режим эмуляции. Требует значение типа bool.

  • PDO::MYSQL_ATTR_USE_BUFFERED_QUERY (доступен в MySQL): Использовать буферизованные запросы.

  • PDO::ATTR_DEFAULT_FETCH_MODE: Устанавливает режим выборки данных по умолчанию. Описание возможных режимов приведено в документации к методу PDOStatement::fetch().

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.