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

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

MYSQLI_READ_DEFAULT_GROUP (int)

Считывает опции именованной группы из файла my.cnf или файла, который указали константой MYSQLI_READ_DEFAULT_FILE.

MYSQLI_READ_DEFAULT_FILE (int)

Считывает опции из именованного файла параметров, а не из файла my.cnf.

MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS (int)

Указывает серверу, что клиенту разрешается работать в режиме песочницы с просроченными паролями. Константу передают в функцию mysqli_options().

MYSQLI_OPT_LOAD_DATA_LOCAL_DIR (int)

Опция определяет каталог, из которого клиентской стороне разрешается загрузка данных из файла в таблицу через модификатор LOCAL в инструкции LOAD DATA LOCAL.

MYSQLI_OPT_CONNECT_TIMEOUT (int)

Время ожидания подключения в секундах.

MYSQLI_OPT_READ_TIMEOUT (int)

Время ожидания результата выполнения команды в секундах. Доступна с PHP 7.2.0.

MYSQLI_OPT_LOCAL_INFILE (int)

Включает команду LOAD LOCAL INFILE.

MYSQLI_OPT_INT_AND_FLOAT_NATIVE (int)

Преобразовывает целочисленные столбцы и столбцы с плавающей точкой обратно в числа PHP. Константа корректно работает только с драйвером mysqlnd.

MYSQLI_OPT_NET_CMD_BUFFER_SIZE (int)

Размер внутреннего буфера команды или сети. Константа корректно работает только с драйвером mysqlnd.

MYSQLI_OPT_NET_READ_BUFFER_SIZE (int)

Максимальный размер блока чтения в байтах при чтении тела пакета команд. Константа корректно работает только с драйвером mysqlnd.

MYSQLI_OPT_SSL_VERIFY_SERVER_CERT (int)

MYSQLI_INIT_COMMAND (int)

Команда, которую функция выполнит при подключении к MySQL-серверу. Функция автоматически перезапустит команду при переподключении.

MYSQLI_CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS (int)

Указывает серверу, что клиенту разрешается работать в режиме песочницы с просроченными паролями. Константу передают в функцию mysqli_real_connect().

MYSQLI_CLIENT_FOUND_ROWS (int)

Возвращает количество совпавших, а не затронутых строк.

MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT (int)

Проверяет сертификат сервера.

MYSQLI_CLIENT_SSL (int)

Использовать протокол шифрования SSL. Прикладные программы не должны устанавливать эту опцию; опция устанавливается внутри клиентской библиотеки MySQL.

MYSQLI_CLIENT_COMPRESS (int)

Использовать компрессию.

MYSQLI_CLIENT_INTERACTIVE (int)

Ждать interactive_timeout секунд (вместо wait_timeout) бездействия перед закрытием соединения. Переменная сессии клиента wait_timeout будет установлена в значение переменной сессии interactive_timeout.

MYSQLI_CLIENT_IGNORE_SPACE (int)

Разрешить пробелы после названий функций. Константа делает имена функций зарезервированными словами.

MYSQLI_CLIENT_NO_SCHEMA (int)

Запретить синтаксис db_name.tbl_name.col_name.

MYSQLI_CLIENT_MULTI_QUERIES

Разрешить выполнение в одном вызове функции mysqli_query() нескольких запросов, разделённых точкой с запятой.

MYSQLI_STORE_RESULT (int)

Для использования буферизации наборов данных. Значение равно 0.

MYSQLI_STORE_RESULT_COPY_DATA (int)

С PHP 8.1 константа больше ни на что не влияет. До PHP 8.1 константу указывали для копирования результатов из внутреннего буфера драйвера mysqlnd в извлечённые PHP-переменные. По умолчанию драйвер mysqlnd будет использовать логику ссылок, чтобы избежать копирования и дублирования результатов, которые хранятся в памяти. Для конкретных наборов результатов, например, наборов результатов с большим количеством небольших строк, подход копирования может уменьшить общее потребление памяти, поскольку PHP-переменные, которые содержат результаты, могут освободиться раньше. Константа доступна только с драйвером mysqlnd. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_USE_RESULT (int)

Для работы с небуферизированными наборами результатов. Значение равно 1.

MYSQLI_ASSOC (int)

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

MYSQLI_NUM (int)

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

MYSQLI_BOTH (int)

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

MYSQLI_NOT_NULL_FLAG (int)

Информирует о том, что поле определили как NOT NULL.

MYSQLI_PRI_KEY_FLAG (int)

Поле — часть первичного индекса.

MYSQLI_UNIQUE_KEY_FLAG (int)

Поле — часть уникального индекса.

MYSQLI_MULTIPLE_KEY_FLAG (int)

Поле — часть индекса.

MYSQLI_BLOB_FLAG (int)

Поле определили как BLOB.

MYSQLI_UNSIGNED_FLAG (int)

Поле определили как UNSIGNED.

MYSQLI_ZEROFILL_FLAG (int)

Поле определили как ZEROFILL.

MYSQLI_AUTO_INCREMENT_FLAG (int)

Поле определили как AUTO_INCREMENT.

MYSQLI_TIMESTAMP_FLAG (int)

Поле определили как TIMESTAMP.

MYSQLI_SET_FLAG (int)

Поле определили как SET.

MYSQLI_NUM_FLAG (int)

Поле определили как NUMERIC.

MYSQLI_PART_KEY_FLAG (int)

Поле — часть многоколоночного индекса.

MYSQLI_GROUP_FLAG (int)

Поле — часть инструкции GROUP BY.

MYSQLI_NO_DEFAULT_VALUE_FLAG (int)

В определении столбца нет предложения DEFAULT. Это не относится к столбцам NULL, поскольку значение по умолчанию такого столбца равно NULL, и AUTO_INCREMENT, поскольку у такого столбца есть значение по умолчанию, которое подразумевается.

MYSQLI_TYPE_DECIMAL (int)

Поле определили как DECIMAL.

MYSQLI_TYPE_NEWDECIMAL (int)

Математическая точность полей DECIMAL или NUMERIC.

MYSQLI_TYPE_BIT (int)

Поле определили как BIT.

MYSQLI_TYPE_TINY (int)

Поле определили как TINYINT.

MYSQLI_TYPE_SHORT (int)

Поле определили как SMALLINT.

MYSQLI_TYPE_LONG (int)

Поле определили как INT.

MYSQLI_TYPE_FLOAT (int)

Поле определили как FLOAT.

MYSQLI_TYPE_DOUBLE (int)

Поле определили как DOUBLE.

MYSQLI_TYPE_NULL (int)

Поле определили как DEFAULT NULL.

MYSQLI_TYPE_TIMESTAMP (int)

Поле определили как TIMESTAMP.

MYSQLI_TYPE_LONGLONG (int)

Поле определили как BIGINT.

MYSQLI_TYPE_INT24 (int)

Поле определили как MEDIUMINT.

MYSQLI_TYPE_DATE (int)

Поле определили как DATE.

MYSQLI_TYPE_TIME (int)

Поле определили как TIME.

MYSQLI_TYPE_DATETIME (int)

Поле определили как DATETIME.

MYSQLI_TYPE_YEAR (int)

Поле определили как YEAR.

MYSQLI_TYPE_NEWDATE (int)

Поле определили как DATE.

MYSQLI_TYPE_INTERVAL (int)

Псевдоним константы MYSQLI_TYPE_ENUM. Константа удалена с PHP 8.4.0.

MYSQLI_TYPE_ENUM (int)

Поле определили как ENUM.

MYSQLI_TYPE_SET (int)

Поле определили как SET.

MYSQLI_TYPE_TINY_BLOB (int)

Поле определили как TINYBLOB.

MYSQLI_TYPE_MEDIUM_BLOB (int)

Поле определили как MEDIUMBLOB.

MYSQLI_TYPE_LONG_BLOB (int)

Поле определили как LONGBLOB.

MYSQLI_TYPE_BLOB (int)

Поле определили как BLOB.

MYSQLI_TYPE_VAR_STRING (int)

Поле определили как VARCHAR.

MYSQLI_TYPE_STRING (int)

Поле определили как CHAR или BINARY.

MYSQLI_TYPE_CHAR (int)

Поле определили как TINYINT. Для типа CHAR смотрите описание константы MYSQLI_TYPE_STRING.

MYSQLI_TYPE_GEOMETRY (int)

Поле определили как GEOMETRY.

MYSQLI_TYPE_JSON (int)

Поле определили как JSON. Константа корректно работает только с драйвером mysqlnd и MySQL 5.7.8 или выше.

MYSQLI_TYPE_VECTOR (int)

Поле определили как VECTOR.

MYSQLI_NEED_DATA

Доступно больше данных для связанной переменной.

MYSQLI_ENUM_FLAG (int)

Поле определили как ENUM.

MYSQLI_BINARY_FLAG (int)

Поле определили как BINARY.

MYSQLI_CURSOR_TYPE_FOR_UPDATE (int)

Константа удалена с PHP 8.4.0.

MYSQLI_CURSOR_TYPE_NO_CURSOR (int)

MYSQLI_CURSOR_TYPE_READ_ONLY (int)

MYSQLI_CURSOR_TYPE_SCROLLABLE (int)

Константа удалена с PHP 8.4.0.

MYSQLI_STMT_ATTR_CURSOR_TYPE (int)

MYSQLI_STMT_ATTR_PREFETCH_ROWS (int)

Константа удалена с PHP 8.4.0.

MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH (int)

MYSQLI_SET_CHARSET_NAME (int)

MYSQLI_REPORT_INDEX (int)

Сообщить о запросе без индекса или с плохим индексом.

MYSQLI_REPORT_ERROR (int)

Сообщить об ошибках вызова функций mysqli-модуля.

MYSQLI_REPORT_STRICT (int)

Выбрасывать исключения mysqli_sql_exception вместо предупреждений, если возникла ошибка.

MYSQLI_REPORT_ALL (int)

Включить все уведомления.

MYSQLI_REPORT_OFF (int)

Отключает уведомления.

MYSQLI_DEBUG_TRACE_ENABLED (int)

При работе функции mysqli_debug() для константы устанавливается значение 1.

MYSQLI_SERVER_PUBLIC_KEY (int)

MYSQLI_REFRESH_GRANT (int)

Обновляет таблицу прав доступа. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_LOG (int)

Сбрасывает логи, точно так же, как и SQL-инструкция FLUSH LOGS. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_TABLES (int)

Очищает кеш таблицы, точно так же, как и SQL-инструкция FLUSH TABLES. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_HOSTS (int)

Очищает кеш хоста, точно так же, как и SQL-инструкция FLUSH HOSTS. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_REPLICA (int)

Синоним константы MYSQLI_REFRESH_SLAVE. Константа доступна с PHP 8.1.0. Объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_STATUS (int)

Сбрасывает переменные состояния, точно так же, как и SQL-инструкция FLUSH STATUS. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_THREADS (int)

Очищает кеш потока. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_SLAVE (int)

На ведомом сервере репликации (slave): сбрасывает информацию ведущего сервера (master) и перезапускает ведомый сервер. Аналогично выполнению SQL-инструкции RESET SLAVE. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_MASTER (int)

На ведущем сервере репликации (master): удаляет бинарные файлы логов в бинарном индексе логов, и обрезает файл индекса. Аналогично выполнению SQL-инструкции RESET MASTER. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_REFRESH_BACKUP_LOG (int)

Закрывает и снова открывает файлы лога резервного копирования. Константа объявлена устаревшей с PHP 8.4.0.

MYSQLI_TRANS_COR_AND_CHAIN (int)

Добавляет предложение «AND CHAIN» к действиям функций mysqli_commit() или mysqli_rollback().

MYSQLI_TRANS_COR_AND_NO_CHAIN (int)

Добавляет предложение «AND NO CHAIN» к действиям функций mysqli_commit() или mysqli_rollback().

MYSQLI_TRANS_COR_RELEASE (int)

Добавляет предложение «RELEASE» к действиям функций mysqli_commit() или mysqli_rollback().

MYSQLI_TRANS_COR_NO_RELEASE (int)

Добавляет предложение «NO RELEASE» к действиям функций mysqli_commit() или mysqli_rollback().

MYSQLI_TRANS_START_READ_ONLY (int)

Начинает транзакцию как «START TRANSACTION READ ONLY» с mysqli_begin_transaction().

MYSQLI_TRANS_START_READ_WRITE (int)

Начинает транзакцию с инструкции «START TRANSACTION READ WRITE» при запуске функции mysqli_begin_transaction().

MYSQLI_TRANS_START_WITH_CONSISTENT_SNAPSHOT (int)

Начинает транзакцию с инструкции "START TRANSACTION WITH CONSISTENT SNAPSHOT".

MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT (int)

Требуется MySQL 5.6.5 и выше.

MYSQLI_IS_MARIADB (bool)

Определяет, собрали ли модуль mysqli с клиентской библиотекой MariaDB. Константа доступна с PHP 8.1.2.

MYSQLI_ASYNC (int)

Запрос выполняется асинхронно, и набор результатов не возвращается сразу. Константа доступна только с драйвером mysqlnd.

MYSQLI_ON_UPDATE_NOW_FLAG (int)

При обновлении поле получит текущее значение времени.