在phpEnv集成环境中运行PHP项目时，MySQL连接超时是常见问题。这通常和MySQL服务端的超时设置、最大连接数限制，以及PHP脚本里的连接参数有关。通过合理优化这些参数，可以显著减少超时错误。
一、认识phpEnv中MySQL超时的常见表现
在phpEnv下启动MySQL后，如果项目频繁出现以下信息，就可能是连接超时：
- SQLSTATE[HY000] [2002] Connection timed out
- MySQL server has gone away
- 页面首次访问极慢，后续正常
二、优化MySQL服务端参数
phpEnv的MySQL配置文件一般位于软件目录下的mysql/my.ini。我们可以调整以下几个关键参数。
1. 修改my.ini核心参数
在[mysqld]区块中加入或修改如下内容：
[mysqld] wait_timeout=28800 interactive_timeout=28800 connect_timeout=20 max_connections=200 max_allowed_packet=64M
其中wait_timeout控制非交互连接空闲时长，connect_timeout是连接握手超时，max_connections决定并发上限。
2. 重启MySQL服务
在phpEnv面板中停止并重新启动MySQL，使配置生效。
三、PHP端连接参数优化
使用PDO或mysqli时，也可以显式设置连接超时，避免沿用默认值过短。
1. PDO方式设置连接超时
<?php
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4';
$user = 'root';
$pass = 'root';
$options = [
PDO::ATTR_TIMEOUT => 20,
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_PERSISTENT => false
];
try {
$pdo = new PDO($dsn, $user, $pass, $options);
echo '连接成功';
} catch (PDOException $e) {
echo '连接失败: ' . $e->getMessage();
}
?>
2. mysqli方式设置超时
<?php
$mysqli = mysqli_init();
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 20);
if ($mysqli->real_connect('127.0.0.1', 'root', 'root', 'test', 3306)) {
echo 'mysqli连接成功';
} else {
echo 'mysqli连接失败: ' . $mysqli->connect_error;
}
?>
四、参数对照与建议
| 参数名 | 作用 | 建议值 |
|---|---|---|
| wait_timeout | 空闲连接回收时间 | 28800秒 |
| connect_timeout | 连接建立超时 | 10到20秒 |
| max_connections | 最大并发连接 | 200左右 |
五、总结
phpEnv下MySQL连接超时主要由配置不当引起。通过同步调整MySQL的my.ini与服务端超时、连接数，以及在PHP代码里设置合理的连接超时选项，就能稳定解决大部分本地开发中的超时故障。