PHP脚本超时需三层协同控制:脚本内set_time_limit()、PHP运行时max_execution_time配置、Web服务器(如Nginx/Apache)超时设置;任一层缺失都会导致超时失效。
PHP 脚本超时不是靠“设个开关”就能稳住的,它分三层控制:脚本内硬性中断、Web 服务器拦截、PHP 运行时配置限制。漏掉任何一层,set_time_limit(30) 都可能被绕过或失效。
set_time_limit() 在代码里动态设上限这是最常用也最容易误用的方式。它从调用点开始重新计时,不是从脚本启动算起;而且在 safe_mode(已废弃)或 disable_functions 包含它时会直接报错。
0 表示取消时间限制(危险,慎用)60)表示最多再运行 N 秒,不是“总时长”max_execution_time 初始值约束
sleep()、file_get_contents() 网络请求),部分版本 PHP 不会计时——实际耗时远超设定值set_time_limit(10); // 后续代码最多还能跑 10 秒,超时抛出致命错误:Fatal error: Maximum execution time of 10 seconds exceeded
max_execution_time 是 PHP-FPM / Apache 的硬门槛这个 ini 配置项才是多数 Web 场景下的真正闸门。它在脚本启动时就生效,比 set_time_limit() 更早介入,且无法被用户代码关闭(除非有权限改 php.ini 或 .htaccess)。
.htaccess 修改:php_value max_execution_time 20
php_admin_value[max_execution_time] = 15(避免被脚本覆盖)0(不限制),所以 php script.php 可能跑很久而 Web 请求早就 504 了即使 PHP 自己没超时,前端服务器也可能先杀掉连接。这时你看到的不是 PHP 错误,而是 504 Gateway Timeout 或 Apache 的 “Premature end of script headers”。
fastcgi_read_timeout 是 60 秒,必须 ≥ PHP 的 max_execution_time,否则白设Timeout 指令(非 max_execution_time)控制整个请求生命周期,包括网络传输,建议设为 PHP 限值的 1.5 倍单靠一个函数或配置,解决不了真实场景里的超时漂移。比如一个循环里调用外部 API,网络卡顿 30 秒,set_time_limit() 根本救不了。
microtime(true) 做分段校验,比依赖全局超时更可控pcntl_alarm()(仅 CLI)发信号中断,但不适用于 FPM/CGI 环境"Fatal error.*execution time" 和 Nginx 的 "upstream timed out",两者不一致说明某层配置脱节超时从来不是“设个数字”就完事的事——它是 PHP 配置、Web 服务、网络链路、业务逻辑四者咬合的结果。少对齐一层,就多一个超时黑盒。