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() - 关闭先前打开的数据库连接