(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::setAttribute — Установка атрибута
Устанавливает атрибут объекту PDO. Некоторые основные атрибуты приведены ниже; отдельные драйверы могут использовать собственные дополнительные атрибуты. Обратите внимание, что атрибуты драйвера не должны использоваться с другими драйверами.
PDO::ATTR_CASE
Принудительное приведение имён столбцов к определённому регистру. Может принимать одно из следующих значений:
PDO::CASE_LOWER
PDO::CASE_NATURAL
PDO::CASE_UPPER
PDO::ATTR_ERRMODE
Режим сообщения об ошибках PDO. Может принимать одно из следующих значений:
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):
true
для включения и false
для выключения.
PDO::ATTR_STATEMENT_CLASS
Установка пользовательского класса оператора, производного от PDOStatement.
Требуется array(string classname, array(mixed constructor_args))
.
Не может использоваться с постоянными экземплярами PDO.
PDO::ATTR_TIMEOUT
Указывает продолжительность времени ожидания в секундах. Принимает значение в виде целого числа (int).
Замечание:
Не все драйверы поддерживают этот параметр и его значение может отличаться от драйвера к драйверу. Например, SQLite будет ждать до этого значения времени, прежде чем отказаться от получения блокировки на запись, но другие драйверы могут интерпретировать это как интервал ожидания соединения или чтения.
PDO::ATTR_AUTOCOMMIT
Замечание: Доступно только для драйверов OCI, Firebird и MySQL.
Следует ли автоматически фиксировать каждый отдельный оператор.
Принимает логическое значение (bool):
true
для включения и false
для отключения. По умолчанию true
.
PDO::ATTR_EMULATE_PREPARES
Замечание: Доступно только для драйверов OCI, Firebird и MySQL.
Включить или отключить эмуляцию подготовленных запросов.
Некоторые драйверы не поддерживают подготовленные запросы нативно или имеют ограниченную поддержку.
Если установлено значение true
PDO всегда будет эмулировать подготовленные запросы,
в противном случае PDO будет пытаться использовать встроенные подготовленные запросы.
Если драйвер не сможет успешно подготовить текущий запрос,
PDO всегда будет возвращаться к эмуляции подготовленного запроса.
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY
Замечание: Доступно только для драйвера MySQL.
Определяет, использовать ли буферизованные запросы.
Принимает логическое значение (bool):
true
для включения и false
для отключения. По умолчанию true
.
PDO::ATTR_DEFAULT_FETCH_MODE
Устанавливает режим выборки по умолчанию. Описание режимов и их использования доступно в документации PDOStatement::fetch().
attribute
Атрибут для изменения.
value
Значение для установки параметра attribute
,
может потребовать определённого типа в зависимости от атрибута.
Возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.