MySQL and PHP
Copyright 1997-2021 the PHP Documentation Group.
mysqli::options
mysqli_options
Set options
Object oriented style
public bool mysqli::options(int option,
mixed value);
Procedural style
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
Procedural style only: A link identifier returned by
mysqli_connect
or
mysqli_init
option
The option that you want to set. It can be one of the following values:
Table 3.10 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. Only valid for mysqlnd. |
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT | Whether to verify server certificate or not. |
value
The value for the option.
Returns true
on success or
false
on failure.
See
mysqli_real_connect
.
MySQLnd always assumes the server default charset. This charset is sent during connection hand-shake/authentication, which mysqlnd will use.
Libmysqlclient uses the default charset set in the
my.cnf
or by an explicit call to
mysqli_options
prior to calling
mysqli_real_connect
,
but after
mysqli_init
.
mysqli_init
|
mysqli_real_connect
|