mysqli::options

mysqli_options

(PHP 5, PHP 7)

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

Описание

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

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 Тайм-аут соединения в секундах (поддерживается в Windows с TCP/IP, начиная с PHP 5.3.1)
MYSQLI_OPT_LOCAL_INFILE Включение/выключение LOAD LOCAL INFILE
MYSQLI_INIT_COMMAND Команда, которую требуется выполнить сразу после подключения к серверу MySQL
MYSQLI_READ_DEFAULT_FILE Читать настройки из именованного файла вместо my.cnf
MYSQLI_READ_DEFAULT_GROUP Читать настройки из именованной группы в файле my.cnf или другом файле, заданным настройкой MYSQL_READ_DEFAULT_FILE.
MYSQLI_SERVER_PUBLIC_KEY Файл публичного ключа RSA для авторизации на базе SHA-2560.
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 в случае возникновения ошибки.

Список изменений

Версия Описание
5.5.0 Добавлены опции MYSQLI_SERVER_PUBLIC_KEY и MYSQLI_SERVER_PUBLIC_KEY.
5.3.0 Добавлены опции MYSQLI_OPT_INT_AND_FLOAT_NATIVE, MYSQLI_OPT_NET_CMD_BUFFER_SIZE, MYSQLI_OPT_NET_READ_BUFFER_SIZE, и MYSQLI_OPT_SSL_VERIFY_SERVER_CERT.

Примеры

См. 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