Установка настроек

# mysqli::options

# mysqli_options

(PHP 5, PHP 7, PHP 8)

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

### Описание

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

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

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

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

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open