array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'mysqli.options.php', 1 => 'mysqli::options', 2 => 'Установка настроек', ), 'up' => array ( 0 => 'class.mysqli.php', 1 => 'mysqli', ), 'prev' => array ( 0 => 'mysqli.next-result.php', 1 => 'mysqli::next_result', ), 'next' => array ( 0 => 'mysqli.ping.php', 1 => 'mysqli::ping', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mysqli/mysqli/options.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli::options

mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Установка настроек

Описание

Объектно-ориентированный стиль

public mysqli::options(int $option, string|int $value): bool

Процедурный стиль

mysqli_options(mysqli $mysql, int $option, string|int $value): bool

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

Эту функцию можно вызывать неоднократно, чтобы задать несколько настроек.

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_OPT_LOAD_DATA_LOCAL_DIR Каталог, который будет использоваться для LOAD DATA 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 Проверять сертификат сервера или нет.
MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS Должен ли клиент принимать просроченные пароли.
1 Использовать ли сжатие сетевых коммуникаций.

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

Смотрите также