php连接超时是开发中常见的异常问题，通常发生在php脚本与数据库建立连接或执行耗时查询的过程中，表现为连接失败、查询无响应等错误。这类问题的核心原因大多是超时时间配置不符合实际业务需求，需要通过调整相关参数来解决。
php连接超时的常见原因
php连接超时主要分为两种场景，对应的触发原因也有所不同：
- 连接阶段超时：php向数据库发起连接请求后，在设定的时间内没有成功建立连接，通常是网络波动、数据库服务负载过高，或者连接超时参数设置过短导致。
- 查询阶段超时：连接已经建立，但是执行复杂查询、批量操作时耗时超过了设定的查询超时时间，也会触发超时错误。
调整数据库超时时间的具体方法
1. 修改php配置文件设置超时
php的mysqli和PDO扩展都有对应的默认超时配置，可以直接在php.ini中修改全局参数，也可以针对单个脚本设置。
如果是使用mysqli扩展，可以在php.ini中调整以下参数：
; 连接超时时间，单位秒，默认通常为5秒 mysqli.connect_timeout = 30 ; 读取数据的超时时间，单位秒 mysqli.default_socket_timeout = 60
如果是使用PDO扩展，对应的配置参数为：
; PDO连接超时时间，单位秒 pdo_mysql.default_socket_timeout = 30
修改完成后需要重启php服务让配置生效，如果是共享主机无法修改php.ini，也可以在脚本中动态设置：
<?php
// mysqli扩展动态设置连接超时
$mysqli = mysqli_init();
// 设置连接超时30秒，查询超时60秒
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 30);
$mysqli->options(MYSQLI_OPT_READ_TIMEOUT, 60);
$mysqli->real_connect('localhost', 'db_user', 'db_pass', 'test_db');
// PDO扩展动态设置超时
$dsn = 'mysql:host=localhost;dbname=test_db;charset=utf8';
$options = [
PDO::ATTR_TIMEOUT => 30, // 连接超时时间，单位秒
];
$pdo = new PDO($dsn, 'db_user', 'db_pass', $options);
?>
2. 调整数据库服务端超时参数
除了php侧的配置，数据库服务端的超时参数也会影响连接和查询的执行，以MySQL为例，需要关注以下几个核心参数：
| 参数名 | 作用 | 默认值 | 建议设置值 |
|---|---|---|---|
| connect_timeout | 连接握手阶段的超时时间，单位秒 | 10 | 20-30 |
| wait_timeout | 非交互连接的空闲超时时间，单位秒 | 28800 | 根据业务调整，避免过短断开连接 |
| interactive_timeout | 交互连接的空闲超时时间，单位秒 | 28800 | 与wait_timeout保持一致 |
| max_execution_time | SELECT语句的最大执行时间，单位毫秒 | 0（不限制） | 根据复杂查询耗时设置，比如30000（30秒） |
修改MySQL参数的方式如下，执行SQL后需要重启MySQL服务或者执行FLUSH VARIABLES;让配置生效：
-- 临时修改参数，重启后失效 SET GLOBAL connect_timeout = 30; SET GLOBAL wait_timeout = 3600; SET GLOBAL max_execution_time = 30000; -- 永久修改需要编辑my.cnf配置文件，添加以下内容 [mysqld] connect_timeout = 30 wait_timeout = 3600 interactive_timeout = 3600 max_execution_time = 30000
3. 代码中针对耗时操作单独设置超时
如果只有部分复杂查询需要更长的超时时间，不需要全局调整参数，可以在代码中单独设置当前连接的超时属性：
<?php
// mysqli方式单独设置查询超时
$mysqli = new mysqli('localhost', 'db_user', 'db_pass', 'test_db');
// 设置当前连接的读取超时时间为120秒
$mysqli->query('SET SESSION max_execution_time = 120000');
// 执行复杂查询
$result = $mysqli->query('SELECT * FROM large_table WHERE complex_condition');
// PDO方式单独设置
$pdo = new PDO('mysql:host=localhost;dbname=test_db', 'db_user', 'db_pass');
$pdo->exec('SET SESSION max_execution_time = 120000');
$stmt = $pdo->query('SELECT * FROM large_table WHERE complex_condition');
?>
超时问题的排查建议
调整超时参数后如果问题仍然存在，可以按照以下步骤排查：
- 检查数据库服务是否正常运行，网络是否通畅，避免是服务不可用导致的连接失败。
- 查看慢查询日志，确认是否有查询耗时远超设置的超时时间，需要优化SQL语句或者增加索引。
- 如果是高并发场景，检查数据库连接池配置，避免连接数耗尽导致的连接超时。
注意：超时时间并不是设置得越长越好，过长的超时时间会占用更多的连接资源，可能导致数据库负载升高，需要根据实际业务场景设置合理的值。
通过以上方法调整php和数据库的超时配置，基本可以解决大部分连接超时的问题，开发者可以根据自身的业务场景选择合适的调整方式。