(PHP 5, PHP 7, PHP 8)
mysqli::options -- mysqli_options — Установка настроек
Объектно-ориентированный стиль
Процедурный стиль
Используется для установки дополнительных настроек соединения и поведения подключения к базе данных.
Эту функцию можно вызывать неоднократно, чтобы задать несколько настроек.
mysqli_options() нужно вызывать после mysqli_init() и перед mysqli_real_connect().
mysqlТолько для процедурного стиля: объект mysqli, который вернула функция mysqli_connect() или функция mysqli_init().
optionНастройка, которую требуется установить. Это может быть одно из следующих значений:
| Имя | Описание |
|---|---|
MYSQLI_OPT_CONNECT_TIMEOUT |
Время ожидания соединения в секундах |
MYSQLI_OPT_READ_TIMEOUT |
Время ожидания результата выполнения команды в секундах. Доступно с PHP 7.2.0. |
MYSQLI_OPT_LOCAL_INFILE |
Включение/выключение LOAD LOCAL INFILE
|
MYSQLI_INIT_COMMAND |
Команда, которую требуется выполнить сразу после подключения к серверу MySQL |
MYSQLI_SET_CHARSET_NAME |
Кодировка, которая будет установлена по умолчанию. |
MYSQLI_READ_DEFAULT_FILE |
Читать настройки из именованного файла вместо my.cnf Не поддерживается mysqlnd. |
MYSQLI_READ_DEFAULT_GROUP |
Читать настройки из именованной группы в файле
my.cnf или другом файле, заданным настройкой
MYSQL_READ_DEFAULT_FILE.
Не поддерживается mysqlnd.
|
MYSQLI_SERVER_PUBLIC_KEY |
Файл публичного ключа RSA для авторизации на базе SHA-256. |
MYSQLI_OPT_NET_CMD_BUFFER_SIZE |
Размер внутреннего командного/сетевого буфера. Работает только с mysqlnd. |
MYSQLI_OPT_NET_READ_BUFFER_SIZE |
Максимальный размер блока для чтения в байтах при чтении командного пакета MySQL. Работает только с mysqlnd. |
MYSQLI_OPT_INT_AND_FLOAT_NATIVE |
Преобразовывает столбцы типов integer и float к числам PHP при использовании неподготовленных выражений. Работает только с mysqlnd. |
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT |
Проверять сертификат сервера или нет. |
valueЗначение настройки.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Если уведомления об ошибках mysqli включены (MYSQLI_REPORT_ERROR) и запрошенная операция не удалась,
выдаётся предупреждение. Если, кроме того, установлен режим MYSQLI_REPORT_STRICT,
вместо этого будет выброшено исключение mysqli_sql_exception.
Смотрите mysqli_real_connect().
Замечание:
MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передаётся во время установки соединения/авторизации, которые использует mysqlnd.
Libmysqlclient по умолчанию использует кодировку, установленную в файле my.cnf или явным вызовом функции mysqli_options() до вызова функции mysqli_real_connect(), но после вызова функции mysqli_connect().