php 8.6.0 与 mariadb 10.11 的持久连接兼容性配置核心在于使用 mysqli 扩展并启用前缀 p:,同时必须确保数据库服务器端的 wait_timeout 设置合理以避免连接被服务端主动断开后 php 仍尝试复用导致的报错。具体做法是在创建连接时,将主机名参数以 p:localhost 的形式传入,这样 mysqli 会自动接管连接的复用逻辑;若遇到连接失效问题,需调整 mariadb 的超时时间或让 php 代码处理断连重连。

如何正确开启 mysqli 持久连接功能
在 PHP 中开启 mysqli 持久连接只需修改连接时的主机名参数即可,无需更改其他配置。将原本的主机名 localhost 替换为 p:localhost,mysqli_connect 函数就会自动尝试复用当前进程已存在的空闲连接,而不是建立新的 TCP 握手。

\u003c?php
$host = 'p:localhost';
$user = 'root';
$password = '';
$dbname = 'test_db';
// 开启错误显示以便调试
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
try {
$link = new mysqli($host, $user, $password, $dbname);
// 检查是否使用了持久连接(通过查看内部状态或行为)
// 这里演示基本的查询操作
$result = $link->query('SELECT 1');
if ($result) {
echo "Connection established successfully with persistent link.\n";
}
} catch (mysqli_sql_exception $e) {
echo "Error: " . $e->getMessage() . "\n";
}
// 脚本结束时,连接不会真正关闭,而是返回到持久连接池
?\u003e
运行上述代码,如果 MariaDB 服务正常运行且用户权限正确,脚本会输出成功信息。关键在于 $host 变量中的 p: 前缀,这是触发持久连接行为的唯一标识。如果没有这个前缀,每次请求都会产生一个新的连接并在脚本结束后立即关闭。
立即学习“PHP免费学习笔记(深入)”;
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
如何处理因 wait_timeout 导致的断连报错
当持久连接在空闲时间超过 MariaDB 的 wait_timeout 后被服务端强制关闭,而 PHP 再次尝试使用该连接执行查询时,会抛出 MySQL server has gone away 错误。解决此问题的最直接方法是在每次从池中获取连接后,检测连接状态并在必要时重新建立连接。

\u003c?php
$host = 'p:localhost';
$user = 'root';
$password = '';
$dbname = 'test_db';
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
function get_persistent_connection($host, $user, $password, $dbname) {
try {
$link = new mysqli($host, $user, $password, $dbname);
// 发送一个简单的 ping 来验证连接是否存活
// 如果连接已断开,mysqli 通常会在下一次查询时报错
// 但我们可以显式检查
if (!$link->ping()) {
// 如果 ping 失败,说明连接已死,需要重新连接
// 注意:对于 p: 前缀,直接关闭再新建可能不会按预期工作
// 更稳妥的方式是捕获异常并重试
throw new Exception('Connection lost');
}
return $link;
} catch (Exception $e) {
// 如果是持久连接池中的死连接,移除它并尝试新建
// 在实际生产中,可能需要更复杂的连接池管理
// 这里为了演示,我们尝试不使用 p: 前缀进行重连作为备选
// 或者依赖 PHP 内部的错误处理机制
// 另一种常见做法是捕获 mysqli_sql_exception 并重试一次
// 但为了简单起见,我们假设在应用层处理
return null;
}
}
$link = get_persistent_connection($host, $user, $password, $dbname);
if ($link) {
try {
$result = $link->query('SELECT 1');
echo "Query executed successfully.\n";
} catch (mysqli_sql_exception $e) {
// 如果仍然失败,记录日志或采取其他措施
echo "Persistent connection failed after retry: " . $e->getMessage() . "\n";
}
} else {
echo "Failed to establish a valid connection.\n";
}
?\u003e
上述代码展示了一种基础的健壮性处理。虽然 mysqli 的持久连接功能在 PHP 层面是透明的,但服务端的行为是不可控的。因此,在代码中加入 ping() 检查或捕获特定异常并重试,是保证高可用性的关键步骤。此外,也可以调整 MariaDB 的 wait_timeout 全局变量或会话变量,将其设置为一个较长的值,从而减少连接被意外断开的频率。
持久连接在并发场景下的资源占用情况
在并发请求较高的场景下,持久连接会导致每个 PHP-FPM 子进程都持有一个数据库连接。如果 PHP-FPM 的子进程数量较多,数据库侧的连接数会迅速增加,可能达到 MariaDB 的 max_connections 限制。例如,如果设置了 50 个 PHP-FPM 子进程,每个进程维护一个持久连接,那么仅用于这些进程的常驻连接数就是 50。这要求 DBA 确保 max_connections 设置足够大,以容纳所有可能的并发 PHP 进程连接,否则新请求可能会因为无法获取连接而失败。


















