mysqli::options

函数名

mysqli::options

适用 PHP 版本

PHP 5, PHP 7, PHP 8

函数说明

mysqli::options 函数用于在建立连接前设置 MySQLi 连接的选项。这个函数通常在调用 mysqli::real_connect() 之前使用，用于修改默认连接行为，例如设置连接超时时间、启用压缩等。

函数语法

bool mysqli::options ( int $option , mixed $value )

参数

• $option：要设置的选项，使用 MySQLi 提供的常量，如 MYSQLI_OPT_CONNECT_TIMEOUT、MYSQLI_OPT_LOCAL_INFILE 等。
• $value：要为该选项设置的值，类型依据选项而定，通常是整型或布尔型。

返回值

成功时返回 true，失败时返回 false。

示例

  <?php
  $mysqli = new mysqli();
<p>// 设置连接超时时间为 5 秒<br>
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);</p>
<p>// 启用 local infile<br>
$mysqli->options(MYSQLI_OPT_LOCAL_INFILE, true);</p>
<p>// 使用指定参数连接数据库<br>
$mysqli->real_connect("localhost", "user", "password", "database");</p>
<p>if ($mysqli->connect_error) {<br>
die("连接失败: " . $mysqli->connect_error);<br>
}</p>
<p>echo "连接成功";<br>
?><br>

示例代码的说明

该示例首先创建了一个未连接的 MySQLi 对象，然后使用 mysqli::options 设置两个连接前的选项：一个是连接超时时间设置为 5 秒，另一个是启用允许使用本地文件导入功能。之后使用 real_connect 方法连接数据库，如果连接失败则输出错误信息，成功则输出提示。