Обумовлені константи

Наведені нижче константи визначені цим модулем і доступні або в збірках 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.

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

Loading...

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.)