讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

PHP8.6.0与MariaDB10.11持久连接兼容性配置

雨晨吖_2476

雨晨吖_2476

发布时间:2026-11-17 09:06:19

|

187人浏览过

|

来源于php中文网

原创

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

PHP8.6.0与MariaDB10.11持久连接兼容性配置

如何正确开启 mysqli 持久连接功能

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

PHP8.6.0与MariaDB10.11持久连接兼容性配置

\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免费学习笔记(深入)”;

PHP 8.5.12
PHP 8.5.12

修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

如何处理因 wait_timeout 导致的断连报错

当持久连接在空闲时间超过 MariaDB 的 wait_timeout 后被服务端强制关闭,而 PHP 再次尝试使用该连接执行查询时,会抛出 MySQL server has gone away 错误。解决此问题的最直接方法是在每次从池中获取连接后,检测连接状态并在必要时重新建立连接。

PHP8.6.0与MariaDB10.11持久连接兼容性配置

\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 进程连接,否则新请求可能会因为无法获取连接而失败。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

13044

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7461

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2275

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4728

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5434

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4271

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6217

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4882

2023.11.13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP自制框架
PHP自制框架

共8课时 | 0.8万人学习

Swoft2.x速学之http api篇课程
Swoft2.x速学之http api篇课程

共16课时 | 1.5万人学习

ThinkPHP5基础讲解视频教程
ThinkPHP5基础讲解视频教程

共38课时 | 15.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn