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