PHP mysqli_options MySQLi 函数
-
定义和用法
mysqli_options - 设置选项 -
版本支持
PHP4 PHP5 PHP7 不支持 支持 支持 5.5.0 新增 MYSQLI_SERVER_PUBLIC_KEY 和 MYSQLI_SERVER_PUBLIC_KEY 选项。
5.3.0 新增 MYSQLI_OPT_INT_AND_FLOAT_NATIVE, MYSQLI_OPT_NET_CMD_BUFFER_SIZE, MYSQLI_OPT_NET_READ_BUFFER_SIZE 和 MYSQLI_OPT_SSL_VERIFY_SERVER_CERT 选项。
-
语法
mysqli_options ( mysqli $link , int $option , mixed $value )
设置一个连接的扩展选项,这些选项可以改变这个连接的行为。 如果要对多个选项进行设置,可以多次调用此函数来。 mysqli_options() 需要在 mysqli_init() 函数之后、 mysqli_real_connect() 函数之前被调用。 -
参数
参数 必需的 描述 link 是 由mysqli_connect() 或 mysqli_init() 返回的链接标识。 option 是 要进行设置的选项,可以是下列中的某一项: - MYSQLI_OPT_CONNECT_TIMEOUT - 连接超时设置,以秒为单位(在 Windows 平台上,PHP 5.3.1 之后才支持此选项)。
- MYSQLI_OPT_LOCAL_INFILE - 启用或禁用 LOAD LOCAL INFILE 语句
- MYSQLI_INIT_COMMAND - 成功建立 MySQL 连接之后要执行的 SQL 语句
- MYSQLI_READ_DEFAULT_FILE - 从指定的文件中读取选项,而不是使用 my.cnf 中的选项
- MYSQLI_READ_DEFAULT_GROUP - 从 my.cnf 或者 MYSQL_READ_DEFAULT_FILE 指定的文件中 读取指定的组中的选项。
- MYSQLI_SERVER_PUBLIC_KEY - SHA-256 认证模式下,要使用的 RSA 公钥文件。
- MYSQLI_OPT_NET_CMD_BUFFER_SIZE - 内部命令/网络缓冲大小, 仅在 mysqlnd 驱动下有效。
- MYSQLI_OPT_NET_READ_BUFFER_SIZE - 以字节为单位,读取 MySQL 命令报文时候的块大小, 仅在 mysqlnd 驱动下有效。
- MYSQLI_OPT_INT_AND_FLOAT_NATIVE - 将整数和浮点数类型的列转换成 PHP 的数值类型, 仅在 mysqlnd 驱动下有效。
- MYSQLI_OPT_SSL_VERIFY_SERVER_CERT -
value 是 选项值。 -
返回值
成功时返回 TRUE, 或者在失败时返回 FALSE。 -
示例
<?php $link = mysqli_init(); if (!$link) { die('mysqli_init failed'); } if (!mysqli_options($link, MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) { die('Setting MYSQLI_INIT_COMMAND failed'); } if (!mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5)) { die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed'); } if (!mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'my_db')) { die('Connect Error (' . mysqli_connect_errno() . ') ' . mysqli_connect_error()); } echo 'Success... ' . mysqli_get_host_info($link) . "\n"; mysqli_close($link);
-
相关函数
mysqli_connect() - 建立一个MySQL连接mysqli_init() - 初始化 MySQLi 并返回一个资源类型的值,这个值可以作为 mysqli_real_connect() 函数的传入参数mysqli_ssl_set() - 使用 SSL 建立到数据库之间的安全连接mysqli_close() - 关闭先前打开的数据库连接