options

创建于 2024-12-03 / 49
字体: [默认] [大] [更大]

❮ PHP MySQLi 参考手册

示例 - 面向对象的样式

设置额外的连接选项:

<?php
$mysqli = mysqli_init();
if (!$mysqli) {
  die("mysqli_init failed");
}

// Specify connection timeout
$con -> options(MYSQLI_OPT_CONNECT_TIMEOUT, 10);

// Specify read options from named file instead of my.cnf
$con -> options(MYSQLI_READ_DEFAULT_FILE, "myfile.cnf");

$con -> real_connect("localhost","my_user","my_password","my_db");
?> 

查看底部的程序样式示例。


定义和用法

options() / mysqli_options() 函数设置额外的连接选项,用于影响连接行为。

options() / mysqli_options() 函数可以被调用若干次来设置若干个选项。

注释: 此函数可以在 mysqli_init() 之后和 mysqli_real_connect() 之前被调用。


语法

面向对象的风格:

$mysqli -> options(option, value)

程序风格:

mysqli_options(connection, option, value)

参数值

参数 描述
connection 必需。规定要使用的 MySQL 连接。
option 必需。规定要设置的选项。可以是下列值中的一个:
  • MYSQLI_OPT_CONNECT_TIMEOUT - 以秒为单位的连接超时时间
  • MYSQLI_OPT_LOCAL_INFILE - 启用/禁用 LOAD LOCAL INFILE
  • MYSQLI_INIT_COMMAND - 在连接到 MySQL 服务器之后的执行命令
  • MYSQLI_READ_DEFAULT_FILE - 从已命名的文件而不是 my.cnf 中读取选项
  • MYSQLI_READ_DEFAULT_GROUP - 从 my.cnf 或者 MYSQLI_READ_DEFAULT_FILE 中指定的文件中的已命名组中读取选项
  • MYSQLI_SERVER_PUBLIC_KEY - 基于 SHA-256 认证的 RSA 公共密钥文件
  • MYSQLI_OPT_NET_CMD_BUFFER_SIZE - only for mysqlnd
  • MYSQLI_OPT_NET_READ_BUFFER_SIZE - only for mysqlnd
  • MYSQLI_OPT_INT_AND_FLOAT_NATIVE - only for mysqlnd
  • MYSQLI_OPT_SSL_VERIFY_SERVER_CERT - only for mysqlnd
value 必需。规定 option 的值。

技术细节

返回值: 若成功则返回 TRUE,若失败则返回 FALSE。
PHP 版本: 5+
PHP 更新日志: PHP 5.5: 新增了 MYSQLI_SERVER_PUBLIC_KEY 选项。
PHP 5.3: 新增了 MYSQLI_OPT_INT_AND_FLOAT_NATIVE, MYSQLI_OPT_NET_CMD_BUFFER_SIZE, MYSQLI_OPT_NET_READ_BUFFER_SIZE, 和 MYSQLI_OPT_SSL_VERIFY_SERVER_CERT 选项。

示例 - 程序样式

设置额外的连接选项:

<?php
$con = mysqli_init();
if (!$con) {
  die("mysqli_init failed");
}

// Specify connection timeout
mysqli_options($con, MYSQLI_OPT_CONNECT_TIMEOUT, 10);

// Specify read options from named file instead of my.cnf
mysqli_options($con, MYSQLI_READ_DEFAULT_FILE, "myfile.cnf");

mysqli_real_connect($con,"localhost","my_user","my_password","my_db");
?> 

❮ PHP MySQLi 参考手册
0 人点赞过