PHP应用MySQL连接超时需从四方面解决:一、修改MySQL配置文件中wait_timeout和interactive_timeout为28800并重启服务;二、用SQL命令动态设置SESSION或GLOBAL超时值;三、PHP层通过ping()保活连接;四、调整PHP执行时间与显式关闭连接。

如果您在本地部署PHP应用后遇到MySQL连接超时问题,通常是因为MySQL服务器默认的等待连接关闭时间(wait_timeout 和 interactive_timeout)过短,导致空闲连接被服务端主动断开。以下是修改MySQL连接时间参数的具体操作步骤:
一、修改MySQL配置文件中的全局超时参数
该方法通过调整MySQL主配置文件,永久性延长非交互式与交互式连接的空闲等待时间。适用于使用mysqld服务长期运行的本地环境。
1、定位MySQL配置文件:Linux/macOS系统通常为/etc/my.cnf或/etc/mysql/my.cnf;Windows系统常见路径为my.ini,位于MySQL安装目录下(如C:\Program Files\MySQL\MySQL Server 8.0\my.ini)。
2、用文本编辑器以管理员权限打开该文件,在[mysqld]段落下新增两行配置:
立即学习“PHP免费学习笔记(深入)”;
wait_timeout = 28800
interactive_timeout = 28800
3、保存文件后,重启MySQL服务:Linux执行sudo systemctl restart mysql或sudo service mysql restart;Windows可在服务管理器中重启“MySQL80”服务。
二、通过SQL命令动态修改当前会话或全局超时值
该方法无需重启MySQL服务,适用于临时调试或无法修改配置文件的受限环境。修改仅对当前会话或后续新连接生效,重启后失效。
1、使用root或其他具有SUPER权限的账户登录MySQL命令行客户端:mysql -u root -p。
2、执行以下语句设置当前会话的超时时间为8小时(28800秒):
SET SESSION wait_timeout = 28800;
SET SESSION interactive_timeout = 28800;
3、若需影响所有新连接(需SUPER权限),执行:
SET GLOBAL wait_timeout = 28800;
SET GLOBAL interactive_timeout = 28800;
三、在PHP连接层增加连接保活机制
该方法不依赖MySQL服务端配置,通过PHP代码在连接空闲期间发送轻量心跳包,防止连接被中间网络设备或MySQL自身中断。
1、若使用PDO,创建DSN时添加&mysqlnd_ms.enable=1无效,应改用PDO::ATTR_EMULATE_PREPARES配合定期ping:
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
2、在每次数据库操作前调用ping()方法检测并重连:
if (!$pdo->ping()) { $pdo = new PDO($dsn, $user, $pass); }
3、若使用mysqli扩展,可在查询前执行:
$mysqli->ping();
四、检查并调整PHP脚本执行时间与连接生命周期
PHP脚本执行超时(max_execution_time)或连接未显式关闭,可能间接加剧MySQL连接堆积与超时感知。需确保连接及时释放并匹配服务端策略。
1、在PHP配置文件php.ini中确认以下参数值合理:
max_execution_time = 300
default_socket_timeout = 60
2、在脚本末尾或使用完数据库后,显式关闭连接:
mysqli_close($connection);
unset($pdo);
3、避免在长循环中复用同一连接而不做ping检测,应将连接封装为可重连对象。











