phpm.ru | Установка настроек

Описание

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

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

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

mysqli_options ( mysqli $link , int $option , mixed $value ) : bool

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

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

mysqli_options() нужно вызывать после mysqli_init() и перед mysqli_real_connect().

Список параметров

link

Только для процедурного стиля: Идентификатор соединения, полученный с помощью 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_real_connect().

Примечания

Замечание:
MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передается во время установки соединения/авторизации, которые использует mysqlnd.
Libmysqlclient по умолчанию использует кодировку, установленную в my.cnf или специальным вызовом mysqli_options() до использования mysqli_real_connect(), но после mysqli_init().

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

mysqli_init() - Инициализирует MySQLi и возвращает объект для использования в функции mysqli_real_connect()
mysqli_real_connect() - Устанавливает соединение с сервером mysql