mysqli::poll 函数

适用PHP版本

PHP 5.3.0 及以上版本

函数说明

mysqli::poll 函数用于轮询一组 MySQLi 连接，等待这些连接中的任意一个变为可读、可写或发生错误。这对于实现非阻塞数据库操作，尤其是当有多个并行查询时非常有用。

函数语法

public static mysqli::poll(array &$read, array &$error, array &$reject, int $sec, int $usec = 0): int|false

参数

&$read：传入一个包含 mysqli 对象的数组，函数会返回其中可读的连接。
&$error：传入一个包含 mysqli 对象的数组，函数会返回其中出现错误的连接。
&$reject：传入一个包含 mysqli 对象的数组，函数会返回其中被拒绝的连接。
$sec：等待的秒数。
$usec：等待的微秒数，默认为0。

返回值

返回轮询到的连接数（整型）。如果出错，返回 false。

示例

$links = [
  new mysqli('host1', 'user', 'pass', 'db'),
  new mysqli('host2', 'user', 'pass', 'db')
];
<p>$read = $links;<br>
$error = [];<br>
$reject = [];</p>
<p>$num_changed = mysqli::poll($read, $error, $reject, 1);</p>
<p>if ($num_changed === false) {<br>
echo "轮询失败。";<br>
} elseif ($num_changed > 0) {<br>
echo "有 {$num_changed} 个连接状态已变化。\n";<br>
foreach ($read as $readable) {<br>
// 处理可读连接<br>
echo "连接可读。\n";<br>
}<br>
foreach ($error as $errored) {<br>
// 处理出错连接<br>
echo "连接出错。\n";<br>
}<br>
foreach ($reject as $rejected) {<br>
// 处理被拒连接<br>
echo "连接被拒绝。\n";<br>
}<br>
} else {<br>
echo "没有连接状态变化。";<br>
}<br>