mysqli::refresh

适用 PHP 版本

PHP 5 >= 5.3.0，PHP 7，PHP 8

函数说明

mysqli::refresh 是用于刷新 MySQL 连接状态的方法。此函数可以用于重新读取用户权限表、刷新查询缓存或者关闭空闲连接等操作，通常用于管理操作或高级连接维护。

函数语法

public mysqli::refresh(int $options): bool

过程化风格语法：mysqli_refresh(mysqli $mysql, int $options): bool

参数

• $options：整数型标志，用于指定要刷新的内容。可以使用以下常量（可组合使用）：
  • MYSQLI_REFRESH_GRANT：刷新权限
  • MYSQLI_REFRESH_LOG：刷新日志文件
  • MYSQLI_REFRESH_TABLES：刷新数据表
  • MYSQLI_REFRESH_HOSTS：刷新主机缓存
  • MYSQLI_REFRESH_STATUS：刷新状态变量
  • MYSQLI_REFRESH_THREADS：刷新线程缓存
  • MYSQLI_REFRESH_SLAVE：重新启动复制从服务器
  • MYSQLI_REFRESH_MASTER：重新启动复制主服务器

返回值

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

示例

  <?php
  $mysqli = new mysqli("localhost", "user", "password", "database");
<p>if ($mysqli->connect_error) {<br>
die("连接失败: " . $mysqli->connect_error);<br>
}</p>
<p>// 刷新权限和数据表<br>
if ($mysqli->refresh(MYSQLI_REFRESH_GRANT | MYSQLI_REFRESH_TABLES)) {<br>
echo "刷新成功";<br>
} else {<br>
echo "刷新失败";<br>
}</p>
<p>$mysqli->close();<br>
?><br>

示例代码的说明

本示例创建了一个 MySQLi 连接，并使用 refresh 方法刷新了权限信息和数据表缓存。如果刷新成功，则输出“刷新成功”，否则输出“刷新失败”。