mysqli::options

mysqli_options

(PHP 5)

mysqli::options -- mysqli_options — Set 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.
`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.

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_init() - Initializes MySQLi and returns a resource for use with mysqli_real_connect()
mysqli_real_connect() - 建立一个 MySQL 服务器连接

用户评论:

[#1] king at bobfish dot org [2008-02-14 12:05:26]

Example on using mysqli_options to increase size of max_allowed_packet for working with big blobs.

function dbConnect()
{
   $user = 'jomama';
   $pass = 'cartoon';
   $dbName = 'LifeCycle';
   $host = 'localhost';

   $mysqli = mysqli_init();
   mysqli_options($mysqli,MYSQLI_READ_DEFAULT_GROUP,
                                    "max_allowed_packet=50M");
   mysqli_real_connect($mysqli,$host, $user, $pass,$dbName)
                  or die ('<P>Unable to connect</P>');

   return $mysqli;
}

[#2] fluppy [2007-03-07 14:46:03]

Here es little example to create a SSL Connection

<?php $db = mysqli_init(); $db->ssl_set('server-key.pem','server-cert.pem', 'cacert.pem',NULL,NULL); $db->real_connct('localhost','root','','mydb'); //Here some query $db->close(); ?>