Предопределённые константы

Модуль определяет следующие константы и открывает доступ к ним только тогда, когда модуль либо собрали в PHP, либо динамически загрузили при выполнении кода.

PDO::PARAM_BOOL (int)

Представляет логический тип данных.

PDO::PARAM_NULL (int)

Представляет тип данных SQL NULL.

PDO::PARAM_INT (int)

Представляет тип данных SQL INTEGER.

PDO::PARAM_STR (int)

Представляет типы данных SQL CHAR, VARCHAR и другие строковые типы.

PDO::PARAM_STR_NATL (int)

Флаг для обозначения, что строки используют национальный набор символов. Константа доступна с версии PHP 7.2.0

PDO::PARAM_STR_CHAR (int)

Флаг для обозначения, что строки используют обычный набор символов. Константа доступна с версии PHP 7.2.0

PDO::PARAM_LOB (int)

Представляет в БД SQL тип данных для больших объектов (англ. Large Objects, LOB).

PDO::PARAM_STMT (int)

Представляет тип recordset. На данный момент не поддерживается драйверами.

PDO::PARAM_INPUT_OUTPUT (int)

Указывает, что параметр является параметром INOUT для хранимой процедуры. Для задания типа данных необходимо применить побитовое ИЛИ этой константы с константой типа PDO::PARAM_*.

PDO::FETCH_DEFAULT (int)

Указывает, что должен использоваться режим выборки по умолчанию. Доступно с PHP 8.0.7.

PDO::FETCH_LAZY (int)

Указывает, что метод выборки данных должен возвращать каждую строку в виде объекта с именами свойств, которые соответствуют именам столбцов, которые были возвращены в результирующем наборе. Константа PDO::FETCH_LAZY возвращает объект класса PDORow, который создаёт имена свойств объекта по мере доступа к ним. Константа недействительна внутри метода PDOStatement::fetchAll().

PDO::FETCH_ASSOC (int)

Указывает, что метод, осуществляющий выборку данных, должен возвращать каждую строку результирующего набора в виде ассоциативного массива, индексы которого соответствуют именам столбцов результата выборки. Если в результирующем наборе несколько столбцов с одинаковыми именами, PDO::FETCH_ASSOC будет возвращать по одному значению для каждого столбца. Значения дублирующихся столбцов будут утеряны.

PDO::FETCH_NAMED (int)

Указывает, что метод, осуществляющий выборку данных, должен возвращать каждую строку результирующего набора в виде ассоциативного массива, индексы которого соответствуют именам столбцов результата выборки. Если в результирующем наборе несколько столбцов с одинаковыми именами, PDO::FETCH_NAMED возвращает массив значений для каждого имени столбца.

PDO::FETCH_NUM (int)

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

PDO::FETCH_BOTH (int)

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

PDO::FETCH_OBJ (int)

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

PDO::FETCH_BOUND (int)

Указывает, что метод, осуществляющий выборку данных, должен возвращать TRUE и присваивать значения столбцов таблицы переменным PHP, которые были привязаны методами PDOStatement::bindParam() или PDOStatement::bindColumn().

PDO::FETCH_COLUMN (int)

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

PDO::FETCH_CLASS (int)

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

Замечание: Если в классе нет свойства с необходимым именем, будет вызван магический метод __set().

PDO::FETCH_INTO (int)

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

PDO::FETCH_FUNC (int)

Разрешает настроить обработку данных «на лету» во время выборки (константа действительна только для функции PDOStatement::fetchAll()).

PDO::FETCH_GROUP (int)

Группировка возвращаемых значений. Обычно комбинируется с константами PDO::FETCH_COLUMN или PDO::FETCH_KEY_PAIR.

PDO::FETCH_UNIQUE (int)

Выбирать только уникальные значения, исключать дубли из результата.

PDO::FETCH_KEY_PAIR (int)

Выборка из двух столбцов будет помещена в массив, в котором значения первого столбца принимаются за ключи, а значения второго — за значения.

PDO::FETCH_CLASSTYPE (int)

Определение имени класса по значению первого столбца.

PDO::FETCH_SERIALIZE (int)

Аналогична PDO::FETCH_INTO, но объект представлен в виде сериализованной строки. Конструктор класса не будет вызван, если этот флаг установлен. Объявлена устаревшей, начиная с PHP 8.1.0.

PDO::FETCH_PROPS_LATE (int)

Вызывать конструктор до установки свойств.

PDO::ATTR_AUTOCOMMIT (int)

Если значение false, PDO попытается отключить автоматическую фиксацию изменений в базе данных, таким образом началом транзакции будет установление соединения.

PDO::ATTR_PREFETCH (int)

Изменением размера буфера предвыборки регулируют баланс между расходом памяти и скоростью работы с базой данных. Не все связки база/драйвер поддерживают изменение размера этого буфера. Чем больше этот размер, тем выше быстродействие, но и выше расход памяти.

PDO::ATTR_TIMEOUT (int)

Задаёт время в секундах, в течение которого должен быть завершён обмен с базой данных.

PDO::ATTR_ERRMODE (int)

Подробно об этом атрибуте рассказано в разделе Ошибки и их обработка.

PDO::ATTR_SERVER_VERSION (int)

Этот атрибут предназначен только для чтения; он хранит сведения о версии сервера баз данных, к которому подключён модуль PDO.

PDO::ATTR_CLIENT_VERSION (int)

Этот атрибут предназначен только для чтения; он хранит сведения о версии клиентских библиотек, которые использует драйвер PDO.

PDO::ATTR_SERVER_INFO (int)

Этот атрибут предназначен только для чтения; он хранит сведения о сервере баз данных, к которому подключён модуль PDO.

PDO::ATTR_CONNECTION_STATUS (int)

PDO::ATTR_CASE (int)

Приведение имён столбцов к нужному регистру, который задаётся константами PDO::CASE_*.

PDO::ATTR_CURSOR_NAME (int)

Получение или установка имени курсора. Особенно полезно для работы с прокручиваемыми курсорами или обновления данных в конкретных позициях.

PDO::ATTR_CURSOR (int)

Выбор типа курсора. Драйвер PDO поддерживает два типа курсоров: PDO::CURSOR_FWDONLY и PDO::CURSOR_SCROLL. Если нет уверенности, что нужен именно прокручиваемый курсор, выбирают курсор PDO::CURSOR_FWDONLY.

PDO::ATTR_DRIVER_NAME (string)

Возвращает имя драйвера.

Пример #1 Пример использования константы PDO::ATTR_DRIVER_NAME

<?php
if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
echo "Работаем с mysql; делаем что-то специфичное для mysql\n";
}
?>

PDO::ATTR_ORACLE_NULLS (int)

Преобразование пустых строк в SQL NULL в выборках.

PDO::ATTR_PERSISTENT (mixed)

Запрашивать постоянное соединение вместо установки нового подключения. Подробнее об этом атрибуте смотрите раздел Подключения и управление подключениями.

PDO::ATTR_STATEMENT_CLASS (int)

Устанавливает имя класса, для которого возвращаются запросы (statements).

PDO::ATTR_FETCH_CATALOG_NAMES (int)

Предписание предварять имена столбцов именами каталогов в результирующем наборе. Имя столбца отделяется от имени каталога десятичной точкой (.). Поддержка этого атрибута заложена на уровне драйвера; этот функционал поддерживается не всеми драйверами.

PDO::ATTR_FETCH_TABLE_NAMES (int)

Предписание предварять имена столбцов именами исходных таблиц в результирующем наборе. Имя столбца отделяется от имени таблицы десятичной точкой (.). Поддержка этого атрибута заложена на уровне драйвера; этот функционал поддерживается не всеми драйверами.

PDO::ATTR_STRINGIFY_FETCHES (int)

Принудительно преобразовывать все получаемые значения в строки.

PDO::ATTR_MAX_COLUMN_LEN (int)

Устанавливает максимальную длину имени столбца.

PDO::ATTR_DEFAULT_FETCH_MODE (int)

PDO::ATTR_EMULATE_PREPARES (int)

PDO::ATTR_DEFAULT_STR_PARAM (int)

Устанавливает тип строкового параметра по умолчанию, значением может быть одна из констант: PDO::PARAM_STR_NATL или PDO::PARAM_STR_CHAR. Константа доступна с версии PHP 7.2.0.

PDO::ERRMODE_SILENT (int)

Предписание не выбрасывать исключений в случае ошибок. Ожидается, что разработчик будет явно следить за тем, чтобы не появлялись ошибки. Это режим по умолчанию. Подробнее об этом атрибуте рассказано в разделе Ошибки и их обработка.

PDO::ERRMODE_WARNING (int)

Предписание выдавать сообщение об ошибке PHP уровня E_WARNING. Подробнее об этом атрибуте рассказано в разделе Ошибки и их обработка.

PDO::ERRMODE_EXCEPTION (int)

Предписание выбрасывать исключение PDOException при ошибках. Подробнее об этом атрибуте рассказано в разделе Ошибки и их обработка.

PDO::CASE_NATURAL (int)

Предписание оставлять имена столбцов такими, какими их выдал драйвер базы данных.

PDO::CASE_LOWER (int)

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

PDO::CASE_UPPER (int)

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

PDO::NULL_NATURAL (int)

PDO::NULL_EMPTY_STRING (int)

PDO::NULL_TO_STRING (int)

PDO::FETCH_ORI_NEXT (int)

Предписание выбрать следующую строку из результирующего набора. Константа действительна только для прокручиваемых курсоров.

PDO::FETCH_ORI_PRIOR (int)

Предписание выбрать предыдущую строку из результирующего набора. Константа действительна только для прокручиваемых курсоров.

PDO::FETCH_ORI_FIRST (int)

Предписание выбрать первую строку из результирующего набора. Константа действительна только для прокручиваемых курсоров.

PDO::FETCH_ORI_LAST (int)

Предписание выбрать последнюю строку из результирующего набора. Константа действительна только для прокручиваемых курсоров.

PDO::FETCH_ORI_ABS (int)

Предписание выбрать строку с указанным номером из результирующего набора. Константа действительна только для прокручиваемых курсоров.

PDO::FETCH_ORI_REL (int)

Предписание выбрать строку из результирующего набора относительно текущего положения курсора. Константа действительна только для прокручиваемых курсоров.

PDO::CURSOR_FWDONLY (int)

Предписание создать объект PDOStatement с последовательным курсором. Последовательные курсоры выбраны по умолчанию, так как это наиболее общий и быстрый в PHP шаблон доступа к данным.

PDO::CURSOR_SCROLL (int)

Предписание создать объект PDOStatement с прокручиваемым курсором. Передача констант PDO::FETCH_ORI_* задаёт режим работы курсора, то, как будут выбираться строки из результирующего набора запроса.

PDO::ERR_NONE (string)

Соответствует коду SQLSTATE '00000', который говорит о том, что SQL-запрос выполнен успешно без ошибок или предупреждений. Эта константа повышает удобство при работе с методами PDO::errorCode() или PDOStatement::errorCode() для проверки появления ошибок. Можно также проверять, есть ли ошибка внутри метода, сравнивая его код возврата с этой константой.

PDO::PARAM_EVT_ALLOC (int)

Событие, возникающее при выделении памяти под объект

PDO::PARAM_EVT_FREE (int)

Событие, возникающее при освобождении занимаемой объектом памяти

PDO::PARAM_EVT_EXEC_PRE (int)

Событие, возникающее перед запуском подготовленного запроса.

PDO::PARAM_EVT_EXEC_POST (int)

Событие, возникающее после запуска подготовленного запроса.

PDO::PARAM_EVT_FETCH_PRE (int)

Событие, возникающее перед выборкой данных из результирующего набора.

PDO::PARAM_EVT_FETCH_POST (int)

Событие, возникающее после выборки данных из результирующего набора.

PDO::PARAM_EVT_NORMALIZE (int)

Событие, возникающее во время регистрации параметров, позволяющее драйверу нормализовать имена параметров.

PDO::SQLITE_DETERMINISTIC (int)

Указывает, что функция созданная методом PDO::sqliteCreateFunction() детерминирована, то есть она всегда возвращает одинаковый результат для для одинаковых входных данных в одном выражении SQL. (Доступно с PHP 7.1.4.)