PHP7.1连接数据库时怎样设置连接超时参数-php教程-PHP中文网

mysqli_connect()不支持直接传入connect_timeout参数，必须用mysqli_init()+mysqli_options()+mysqli_real_connect()组合设置mysqli_opt_connect_timeout（单位秒），且需在mysqli_real_connect()前调用；pdo则通过构造时设置pdo::attr_timeout控制连接与首查总时限，但非纯连接超时。

php7.1连接数据库时怎样设置连接超时参数

mysqli_connect() 中设置 connect_timeout 参数

PHP 7.1 的 mysqli 扩展支持在连接阶段控制超时，但不能靠 mysqli_connect() 的前四个参数（主机、用户、密码、库名）直接传入超时值。必须用第五个可选参数 $options 配合 MYSQLI_OPT_CONNECT_TIMEOUT 常量。

常见错误是把超时写成字符串或放在错误位置，比如：mysqli_connect($host, $user, $pass, $db, 5) —— 这里的 5 会被当成端口号，不是超时。

正确写法需显式调用 mysqli_init() + mysqli_options() + mysqli_real_connect()
MYSQLI_OPT_CONNECT_TIMEOUT 单位是秒，只影响 TCP 握手和认证阶段，不控制后续查询执行时间
若设为 0，表示无限等待（不推荐，生产环境至少设为 3–5 秒）

$mysqli = mysqli_init();
mysqli_options($mysqli, MYSQLI_OPT_CONNECT_TIMEOUT, 3);
mysqli_real_connect($mysqli, 'localhost', 'user', 'pass', 'db', 3306);
if (!$mysqli->connect_error) {
    echo "Connected";
}

PDO 构造时用 PDO::ATTR_TIMEOUT 控制连接与查询总耗时

PDO 在 PHP 7.1 中对 MySQL 的 connect_timeout 支持有限，它实际生效的是 PDO::ATTR_TIMEOUT，这个选项同时影响连接建立和单条语句执行——不是纯连接超时，而是“首次握手+首次查询”的综合时限。

容易混淆的点：MySQL 服务端本身的 connect_timeout 变量（默认 10 秒）和 PHP 客户端设置会叠加作用，最终以更短的那个为准。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须在 new PDO() 后立刻用 setAttribute() 设置，构造时通过 DSN 传参无效
该值单位是秒，且仅对 MySQL 驱动有效；SQLite 或 PostgreSQL 表现不同
如果连接池或代理（如 ProxySQL）介入，真实超时可能被额外延长

$pdo = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
$pdo->setAttribute(PDO::ATTR_TIMEOUT, 4); // 注意：这是连接+首查总时限

MySQLi 和 PDO 超时行为差异导致的故障现象

当网络抖动或 MySQL 服务假死时，mysqli 可能卡住 30 秒（系统默认 default_socket_timeout），而 PDO 却提前报错——这不是 bug，是两者底层机制不同：mysqli 默认走阻塞 socket，PDO 更倾向使用非阻塞逻辑配合轮询。

典型症状包括：页面加载一半卡住、日志里反复出现 mysqli_real_connect(): (HY000/2002): Connection timed out 或 PDO::__construct(): SQLSTATE[HY000] [2002] Connection refused。

检查 php.ini 中 default_socket_timeout = 60 是否覆盖了你的手动设置
WampServer/XAMPP 环境下，MySQL 服务未启动时，mysqli 错误提示更明确；PDO 有时只抛 SQLSTATE[HY000]，需结合 errno 判断
超时设置无法解决 DNS 解析慢问题，若用域名连接，建议改用 IP 或配置本地 hosts