Опис

Об'єктно-орієнтований стиль

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

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

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

Used to set extra connect options and affect behavior for a connection.

This function may be called multiple times to set several options.

mysqli_options() should be called after mysqli_init() and before mysqli_real_connect().

Параметри

mysql

Тільки процедурний стиль: об'єкт mysqli, якого повертає функція mysqli_connect() або mysqli_init()

option

The option that you want to set. It can be one of the following values:
Valid options

Name Description

MYSQLI_OPT_CONNECT_TIMEOUT Connection timeout in seconds

MYSQLI_OPT_READ_TIMEOUT Command execution result timeout in seconds. Available as of PHP 7.2.0.

MYSQLI_OPT_LOCAL_INFILE Enable/disable use of LOAD LOCAL INFILE

MYSQLI_INIT_COMMAND Command to execute after when connecting to MySQL server

MYSQLI_SET_CHARSET_NAME The charset to be set as default.

MYSQLI_READ_DEFAULT_FILE Read options from named option file instead of my.cnf Not supported by mysqlnd.

MYSQLI_READ_DEFAULT_GROUP Read options from the named group from my.cnf or the file specified with MYSQL_READ_DEFAULT_FILE. Not supported by mysqlnd.

MYSQLI_SERVER_PUBLIC_KEY RSA public key file used with the SHA-256 based authentication.

MYSQLI_OPT_NET_CMD_BUFFER_SIZE The size of the internal command/network buffer. Only valid for mysqlnd.

MYSQLI_OPT_NET_READ_BUFFER_SIZE Maximum read chunk size in bytes when reading the body of a MySQL command packet. Only valid for mysqlnd.

MYSQLI_OPT_INT_AND_FLOAT_NATIVE Convert integer and float columns back to PHP numbers when using non-prepared statements. Only valid for mysqlnd.

MYSQLI_OPT_SSL_VERIFY_SERVER_CERT Whether to verify server certificate or not.

value

**Valid options**
Name	Description
`MYSQLI_OPT_CONNECT_TIMEOUT`	Connection timeout in seconds
`MYSQLI_OPT_READ_TIMEOUT`	Command execution result timeout in seconds. Available as of PHP 7.2.0.
`MYSQLI_OPT_LOCAL_INFILE`	Enable/disable use of `LOAD LOCAL INFILE`
`MYSQLI_INIT_COMMAND`	Command to execute after when connecting to MySQL server
`MYSQLI_SET_CHARSET_NAME`	The charset to be set as default.
`MYSQLI_READ_DEFAULT_FILE`	Read options from named option file instead of `my.cnf` Not supported by mysqlnd.
`MYSQLI_READ_DEFAULT_GROUP`	Read options from the named group from `my.cnf` or the file specified with `MYSQL_READ_DEFAULT_FILE`. Not supported by mysqlnd.
`MYSQLI_SERVER_PUBLIC_KEY`	RSA public key file used with the SHA-256 based authentication.
`MYSQLI_OPT_NET_CMD_BUFFER_SIZE`	The size of the internal command/network buffer. Only valid for mysqlnd.
`MYSQLI_OPT_NET_READ_BUFFER_SIZE`	Maximum read chunk size in bytes when reading the body of a MySQL command packet. Only valid for mysqlnd.
`MYSQLI_OPT_INT_AND_FLOAT_NATIVE`	Convert integer and float columns back to PHP numbers when using non-prepared statements. Only valid for mysqlnd.
`MYSQLI_OPT_SSL_VERIFY_SERVER_CERT`	Whether to verify server certificate or not.

The value for the option.

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки.

Помилки/виключення

Якщо увімкнені звіти про помилки mysqli (MYSQLI_REPORT_ERROR) і запитана операція не виконалась, буде виведено попередження, але якщо встановлено режим MYSQLI_REPORT_STRICT, буде викинуто виключення mysqli_sql_exception.

Приклади

See mysqli_real_connect().

Примітки

Зауваження:
MySQLnd завжди використовує стандартне кодування символів на сервері. Це кодування надсилається на етапі з'єднання/автентифікації, які використовує mysqlnd.
Libmysqlclient використовує кодування символів, вказане у файлі my.cnf, або явним викликом функції mysqli_options() перед викликом mysqli_real_connect(), але після mysqli_init().

Прогляньте також

mysqli_init() - Initializes MySQLi and returns an object for use with mysqli_real_connect()
mysqli_real_connect() - Opens a connection to a mysql server