PHP修改MySQL连接超时设置

在 phpEnv 本地开发环境中，MySQL 的 interactive_timeout 和 wait_timeout 设置常因配置文件路径错误或未重启服务而失效——关键在于必须修改 phpEnv 私有目录下的 my.ini 或 my.cnf（如 C:\phpEnv\bin\mysql\my.ini 或 macOS/Linux 下通过 mysqld 启动参数定位），在 [mysqld] 段同时添加 wait_timeout=300 和 interactive_timeout=300，并强制重启 MySQL 服务；仅执行 SET GLOBAL 无效，且 PHP 默认短连接机制要求配合连接探活（如执行 SELECT 1）或合理启用持久连接，再辅以开启错误日志，才能真正解决开发中诡异的连接中断问题。

phpEnv 环境下改 interactive_timeout 无效，大概率是因为你改错了配置文件位置，或没触发 MySQL 服务重启——phpEnv 自带的 MySQL 是独立安装、自管理的，不读系统级 /etc/my.cnf。

确认 phpEnv 实际使用的 MySQL 配置文件路径

phpEnv 并非标准 Linux 发行版环境，它把 MySQL 安装在私有目录里（如 C:\phpEnv\bin\mysql\ 或 /Applications/phpEnv/bin/mysql/），其配置文件通常不在全局路径。直接改 /etc/my.cnf 完全没用。

• Windows 下：打开 C:\phpEnv\bin\mysql\my.ini（或 my.cnf）；常见路径还有 C:\phpEnv\bin\mysql\conf\my.cnf
• macOS/Linux 下：查 ps aux | grep mysqld，看启动命令里带的 --defaults-file= 参数，或执行 /path/to/phpEnv/bin/mysql/bin/mysqld --verbose --help | grep "Default options"
• 改之前先连上 MySQL 执行 SHOW VARIABLES LIKE 'config_file';（MySQL 8.0.22+ 支持），它会直接告诉你当前加载的是哪个文件

在 phpEnv 的 my.ini / my.cnf 中安全设置 interactive_timeout

找到正确的配置文件后，在 [mysqld] 段落里添加两行，必须同时设两个值：

wait_timeout = 300
interactive_timeout = 300

别只写一个——phpEnv 下 PHP 连接默认走 non-interactive 模式，但某些调试场景（比如用 phpEnv 自带的 mysql 命令行）会触发 interactive 模式，只改 wait_timeout 会导致命令行工具频繁断连。

• 数值建议 300（5 分钟）而非 28800：phpEnv 多用于本地开发，短超时能更快暴露连接泄漏问题
• 不要设成 60 或更小：PHP 脚本执行耗时可能超过 1 分钟（尤其含大查询或 file_get_contents），反而导致刚连上就断
• 改完保存，**必须重启 phpEnv 的 MySQL 服务**：Windows 上用 phpEnv 控制面板点「重启 MySQL」，macOS/Linux 下执行 /path/to/phpEnv/bin/mysql/bin/mysqladmin -u root shutdown 再手动启 mysqld

验证是否生效，以及为什么 SET GLOBAL 不起作用

重启后登录 MySQL，执行：

SELECT @@global.wait_timeout, @@global.interactive_timeout;

输出应为 300。如果还是 28800，说明：

• 配置文件路径不对，或者被同目录下其他 .cnf 文件覆盖（phpEnv 有时会加载 conf.d/ 下多个文件）
• MySQL 启动时加了 --skip-grant-tables 或 --no-defaults，跳过了配置文件
• 你执行了 SET GLOBAL wait_timeout = 300，但它只影响当前运行实例，**phpEnv 重启后就会丢**，且新连接仍按配置文件初始值拉起

特别注意：SET SESSION 对当前连接有效，但 PHP 脚本每次请求都是新连接（除非用长连接池），所以 session 级修改对 Web 请求完全无意义。

PHP 层必须配合做连接保活，否则光调 MySQL 没用

phpEnv 里 PHP 默认不启用连接池，每个请求新建 MySQL 连接，但若脚本中途 sleep 或阻塞超时，连接可能卡在 Sleep 状态直到被 MySQL kill。这时仅靠调大 timeout 是掩耳盗铃。

• 在 PDO 连接字符串末尾加 ;options[]=PDO::ATTR_PERSISTENT 启用持久连接（慎用，易引发状态污染）
• 更推荐：在关键逻辑前加 $pdo->query('SELECT 1')->fetch(); 做轻量探活，比 ping() 更可靠（ping() 在 MySQL 8.0.19+ 已标记为 deprecated）
• 如果用 mysqli，务必检查 mysqli::$connect_error 或捕获 mysqli_sql_exception，失败后重建连接，不能假设连接句柄一直有效

最常被忽略的一点：phpEnv 的 MySQL 日志默认关闭，slow_query_log 和 general_log 都是 off。遇到超时问题，先在配置里打开 log_error = "C:/phpEnv/bin/mysql/data/error.log"，否则连断连原因都看不到。

到这里，我们也就讲完了《PHP修改MySQL连接超时设置》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于phpenv的知识点！