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

Модуль определяет следующие константы и открывает доступ к ним только тогда, когда модуль либо собрали в 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)

Указывает, что метод извлечения данных вернёт новый экземпляр запрошенного класса.

Замечание: Объект инициализируется путём сопоставления столбцов из набора с результатами запроса со свойствами класса. Столбцы сопоставляются до вызова конструктора, что разрешает заполнять свойства независимо от видимости или установки модификатора readonly. PHP вызовет магический метод __set(), если класс не содержит свойства с таким названием и если метод определили в классе; иначе в объекте создаётся динамическое открытое свойство. Однако при установке флага PDO::FETCH_PROPS_LATE конструктор вызывается до заполнения свойств.

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. Курсор с прокруткой выбирают, только когда на 100 % уверены, что требуется прокручиваемый курсор, иначе указывают курсор 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)

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

PDO::ATTR_FETCH_CATALOG_NAMES (int)

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

PDO::ATTR_FETCH_TABLE_NAMES (int)

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

PDO::ATTR_STRINGIFY_FETCHES (int)

Заставляет извлечённые значения, кроме null, обрабатываться как строки. Значения null не изменяются, если только для параметра PDO::ATTR_ORACLE_NULLS не установили значение PDO::NULL_TO_STRING.

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.