MySQLi
PHP 手册

mysqli::options

mysqli_options

(PHP 5)

mysqli::options -- mysqli_optionsSet options

说明

面向对象风格

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

过程化风格

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

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

参数

link

仅以过程化样式:由 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 (supported on Windows with TCP/IP since PHP 5.3.1)
MYSQLI_OPT_LOCAL_INFILE enable/disable use of LOAD LOCAL INFILE
MYSQLI_INIT_COMMAND command to execute after when connecting to MySQL server
MYSQLI_READ_DEFAULT_FILE Read options from named option file instead of my.cnf
MYSQLI_READ_DEFAULT_GROUP Read options from the named group from my.cnf or the file specified with MYSQL_READ_DEFAULT_FILE.
MYSQLI_SERVER_PUBLIC_KEY RSA public key file used with the SHA-256 based authentication.

value

The value for the option.

返回值

成功时返回 TRUE, 或者在失败时返回 FALSE

更新日志

版本 说明
5.5.0 The MYSQLI_SERVER_PUBLIC_KEY option was added.

范例

See mysqli_real_connect().

注释

Note:

MySQLnd 总是使用服务器的默认字符集。此字符集在连接握手/认证时发送,并被 mysqlnd 使用。

Libmysqlclient 使用 my.cnf 中的默认字符集或者由在调用 mysqli_init() 之后, mysqli_real_connect() 之前先调用 mysqli_options() 来指定。

参见


MySQLi
PHP 手册