PHP脚本超时是Web服务器、PHP SAPI层、应用层阻塞操作三层叠加控制,仅调max_execution_time常无效;需同步对齐Nginx fastcgi_read_timeout、PHP-FPM request_terminate_timeout、Apache Timeout等配置,并为I/O操作(如cURL、数据库、文件读取)显式设置超时。

PHP 脚本超时不是单点问题,而是三层叠加控制:Web 服务器 → PHP SAPI 层 → 应用层阻塞操作。只改 max_execution_time 很可能没用。
web 服务器和 php sapi 层的超时必须对齐
Apache、Nginx 或 PHP-FPM 各自都有独立超时机制,PHP 的 max_execution_time 只在 Web SAPI(如 mod_php、php-fpm)下生效,且会被更短的上层超时截断。
- Nginx 的
fastcgi_read_timeout默认常为 60 秒,若 PHP 设置了 300 秒但 Nginx 在 60 秒后断连,用户会收到 504; - PHP-FPM 的
request_terminate_timeout(FPM 模式)或request_slowlog_timeout也会强制 kill 进程,优先级高于 PHP 内部设置; - Apache 的
Timeout指令(非php_value max_execution_time)控制整个请求生命周期,包括 DNS、SSL 握手等,PHP 根本来不及介入。
验证方式:在脚本开头加 error_log("start: " . microtime(true));,结尾加同理日志,再对比 access log 中该请求的耗时——若 PHP 日志显示只跑了 40 秒但 access log 显示 62 秒,大概率是 Web 服务器先掐断了。
set_time_limit() 不是万能重置键,它只重置 CPU 执行时间
set_time_limit() 仅重置 PHP 用户态代码执行的计时器,对 I/O 阻塞完全无效。数据库查询、file_get_contents()、curl_exec()、甚至 fsockopen() 的连接等待,都不算进这个计时。
立即学习“PHP免费学习笔记(深入)”;
- 调用
set_time_limit(0)后脚本仍卡在mysqli_query()上?那是 MySQL 连接或查询超时未设,和 PHP 无关; -
file_get_contents("https://slow-api.com")卡住 2 分钟?必须用stream_context_create(["http" => ["timeout" => 10]])显式控制; - 该函数必须在超时发生前调用,运行中已触发 fatal error 就无法补救;
- CLI 模式下默认不限时(
max_execution_time被忽略),set_time_limit()才真正起作用。
max_input_time 和 max_execution_time 容易混淆但职责分明
max_input_time 控制 PHP 解析请求体的时间(如接收 100MB POST 数据、解析嵌套过深的 JSON),而 max_execution_time 是从解析完成后才开始计时的“业务逻辑时间”。
- 上传大文件失败报 “413 Request Entity Too Large”?那是 Nginx/Apache 限制,不是 PHP;
- 上传成功但脚本卡在
$_FILES处不动?检查max_input_time是否太小(尤其网络慢时,数据传入慢但 PHP 在等); -
max_input_time默认值为 -1,表示继承max_execution_time,但实际中建议显式设为略大于后者(例如 120 秒 vs 90 秒),避免解析阶段被误杀; - 修改
max_input_time后,需重启 PHP-FPM 或 Apache,ini_set()在大多数生产环境已被禁用,不可靠。
外部命令和阻塞调用必须单独设超时
PHP 自身的超时机制对 exec()、shell_exec()、system() 等完全无效。它们交由操作系统调度,PHP 只能被动等待或主动轮询。
- 用
proc_open()+stream_select()是最可控的方式,可精确到秒级中断子进程; - Linux 下可借助系统
timeout命令(如timeout 5s ping -c 3 google.com),但依赖 coreutils 且 Windows 不可用; -
pcntl_alarm()在 CLI 下可用,但 Web SAPI 中多数被禁用(因多请求共享进程),且无法中断系统调用; - 所有 curl 请求必须手动设置
CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT,否则默认是 0(不限时)。
真正的难点从来不在 PHP 配置本身,而在于你是否意识到:DNS 查询、TCP 握手、TLS 协商、数据库连接池排队、磁盘 IO 等环节,全都不受 max_execution_time 约束。这些地方漏设超时,前面所有配置都白调。



















