PDO::setAttribute

PHP PDO 参考手册Справочное руководство по PHP PDO

PDO::setAttribute — Устанавливает атрибут (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Описание

Синтаксис

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

Устанавливает атрибуты для дескриптора базы данных. Ниже перечислены некоторые доступные общие атрибуты; некоторые драйверы могут использовать дополнительные атрибуты, специфичные для драйвера.

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

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

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

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

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

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

    • PDO::ERRMODE_WARNING: Вызывать ошибкуE_WARNINGerror

    • 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 имя класса, array(mixed параметры конструктора))。

  • 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 при неудаче.

Другие расширения