phpEnv中MySQL连接超时需同步修改服务端my.ini的wait_timeout与PHP层PDO的MYSQL_ATTR_CONNECT_TIMEOUT等参数，并用ping()保活，避免localhost改用127.0.0.1。
phpEnv 是 Windows 下轻量级 PHP 开发环境，自带 MySQL（通常是 MariaDB 或 MySQL 5.7/8.0），但默认配置偏保守，wait_timeout 和 connect_timeout 值偏低，加上 Windows 网络栈行为差异，很容易在空闲后出现 PDOException: SQLSTATE[HY000] [2013] Lost connection to MySQL server during query 或 [2002] Connection timed out。
查清 phpEnv 实际用的 MySQL 配置文件路径
phpEnv 不会用系统级 my.ini，它把配置文件放在自己目录下，常见位置是：C:\phpEnv\MySQL\my.ini 或 C:\phpEnv\MySQL\conf\my.ini。直接进 phpEnv 安装目录搜索 my.ini，别去 C:\Windows 或 C:\Program Files 找——那些不是它读的。
打开后确认是否真有 [mysqld] 段落；如果没有，手动加一行 [mysqld] 再写参数。常见错误是把配置写到 [client] 或文件开头无段落标识，MySQL 启动时会忽略。
- 修改前先备份原
my.ini - 改完必须重启 phpEnv 的 MySQL 服务（用 phpEnv 控制面板点「重启 MySQL」，或进 Windows 服务管理器找类似
phpEnv-MySQL的服务） - 验证是否生效：用 phpEnv 自带的 MySQL 客户端执行
SHOW VARIABLES LIKE '%timeout%';，看wait_timeout和interactive_timeout是否已更新
PHP 层必须设 PDO::MYSQL_ATTR_CONNECT_TIMEOUT，别只信 DSN 里的 connect_timeout
phpEnv 默认用 mysqlnd 驱动，但旧版 PDO 构造函数不解析 DSN 中的 connect_timeout=5，写了也白写。真正起作用的是连接选项数组里的 PDO::MYSQL_ATTR_CONNECT_TIMEOUT。
立即学习“PHP免费学习笔记（深入）”；
正确写法：
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4';
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::MYSQL_ATTR_CONNECT_TIMEOUT => 5,
PDO::MYSQL_ATTR_READ_TIMEOUT => 10,
PDO::MYSQL_ATTR_WRITE_TIMEOUT => 10,
];
$pdo = new PDO($dsn, $user, $pass, $options);
-
PDO::ATTR_TIMEOUT对 MySQL 无效，别加——它是给 SQLite 用的 -
host写127.0.0.1而非localhost，避免 Windows 下走命名管道（更慢、超时表现异常） - 如果用 mysqli，必须用
mysqli_init()+options(MYSQLI_OPT_CONNECT_TIMEOUT, 5)，new mysqli()构造函数不接受超时参数
单例连接对象要加心跳保活，不能靠「一直连着」
phpEnv 多用于本地开发调试，请求间隔长（比如改完代码刷一次页面，隔几分钟才下一次），即使服务端 wait_timeout 设成 28800，PHP 进程里存的 $pdo 对象在下次请求时大概率已失效——PHP-FPM worker 进程不会复用上一次请求的 PDO 实例，每次都是新进程，但开发者常误以为「单例」能跨请求续命。
所以不要做「全局静态 PDO 单例」，而要在每次请求入口检测连接状态：
if (!$pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS)) {
$pdo = new PDO($dsn, $user, $pass, $options);
}
// 或更稳妥：用 ping()
if (!$pdo->ping()) {
$pdo = new PDO($dsn, $user, $pass, $options);
}
-
ping()是最轻量的保活方式，比执行SELECT 1更快，且不触发查询日志 - 别在构造 PDO 时设
PDO::ATTR_PERSISTENT => true—— phpEnv 的 MySQL 不适合持久连接，容易因超时堆积僵尸连接 - 如果你用的是 ThinkPHP/Laravel 等框架，检查其数据库配置里是否启用了
keepalive或ping机制；默认可能关着
phpEnv 启动失败或超时卡死？优先检查端口冲突和防火墙
phpEnv 的 MySQL 默认端口是 3306，但 Windows 上常被 Skype、另一套 WAMP/XAMPP 占用。启动时没报错但连不上，大概率是端口监听失败。
排查步骤：
- 命令行运行
netstat -ano | findstr :3306，看 PID 对应哪个进程；如果是非 MySQL 进程，改 phpEnv 的my.ini里port=3307并同步改 PHP 里的host=127.0.0.1;port=3307 - 临时关闭 Windows 防火墙，测试能否连通——某些企业版防火墙会拦截 localhost 回环流量
- phpEnv 控制面板里「MySQL 日志」选项卡，看最后几行有没有
Can't start server : Bind on TCP/IP port类报错
本地开发环境的连接问题，八成出在配置路径错、端口被占、或 ping() 没调用——不是代码逻辑多复杂，而是这些点太容易被跳过。
