MySQLi 持久连接中释放结果集是否必要？-php教程-PHP中文网

MySQLi 持久连接中释放结果集是否必要？

在 MySQLi 持久连接中，显式调用 mysqli_free_result() 或 mysqli_close() 并非必需：PHP 脚本结束时会自动清理结果集，且持久连接本身不受 mysqli_close() 影响；仅在需提前丢弃未读取的未缓冲结果并复用连接执行新查询时，才需手动释放。

在 mysqli 持久连接中，显式调用 `mysqli_free_result()` 或 `mysqli_close()` 并非必需：php 脚本结束时会自动清理结果集，且持久连接本身不受 `mysqli_close()` 影响；仅在需提前丢弃未读取的未缓冲结果并复用连接执行新查询时，才需手动释放。

MySQLi 持久连接（Persistent Connection）通过在 PHP 进程间复用底层数据库连接来减少重复建连开销，其创建方式为在主机名前添加 p: 前缀，例如：

$mysqli = new mysqli('p:localhost', 'user', 'pass', 'db');
// 或使用面向过程风格
$mysqli = mysqli_connect('p:localhost', 'user', 'pass', 'db');

关键事实如下：

✅ mysqli_close() 对持久连接无效
调用 mysqli_close($mysqli) 不会真正关闭连接——它仅解除当前脚本对连接句柄的引用，而底层连接仍保留在连接池中供后续请求复用。官方文档明确指出：“Calling mysqli_close() on a persistent connection has no effect.”
✅ 结果集（result set）无需手动释放
无论是否启用持久连接，PHP 在脚本生命周期结束时（即请求处理完毕、所有变量被销毁时），会自动释放所有未显式释放的 mysqli_result 对象。这意味着以下代码完全安全且推荐：
```
$mysqli = new mysqli('p:localhost', 'user', 'pass', 'db');
$result = $mysqli->query("SELECT id, name FROM users LIMIT 1000");
// 不调用 $result->free() 或 mysqli_free_result($result)
// 脚本结束时自动清理
```
⚠️ 唯一需手动 free_result() 的场景
当使用 未缓冲查询（unbuffered query）（如 mysqli_use_result() 或 mysqli_query() 配合 MYSQLI_USE_RESULT）时，结果集行数据是逐行从服务器流式读取的，若只读取部分行便中断遍历，剩余行仍占用连接资源，此时必须显式释放才能执行下一条语句：
```
$mysqli = new mysqli('p:localhost', 'user', 'pass', 'db');
$result = $mysqli->use_result(); // 未缓冲模式
while ($row = $result->fetch_row()) {
    if ($row[0] === 42) break; // 提前退出
}
$result->free(); // ✅ 必须调用，否则后续 query() 将失败
$mysqli->query("INSERT INTO log (msg) VALUES ('done')");
```
? 持久连接的隐性风险远大于收益
尽管初衷是提升性能，但持久连接易引发状态污染问题：事务未提交、用户变量残留、临时表未清除、字符集/SQL_MODE 不一致等，均可能跨请求“传染”，导致难以复现的逻辑错误。现代 MySQL 连接建立耗时通常低于 1ms（尤其在本地或内网），而连接池、连接复用等更可靠的优化应交由数据库中间件（如 ProxySQL）或应用层连接池（如 Laravel 的 PDO 连接池）实现。除非经压测证实连接开销是瓶颈，否则强烈建议禁用持久连接。