PHP创建文件超时本质是脚本执行时间被限制，需同步调优PHP（max_execution_time/set_time_limit）、Web服务器（Nginx fastcgi_read_timeout/Apache Timeout）及采用分块写入或异步队列方案。
PHP 创建文件时超时，本质是脚本执行时间被限制
PHP 默认 max_execution_time 是 30 秒，一旦创建文件过程（比如写入大日志、生成压缩包、下载并保存远程资源）耗时超过该值，就会直接中止并报 Fatal error: Maximum execution time of X seconds exceeded。这不是磁盘或权限问题，而是 PHP 主动“掐断”了脚本。
- 临时解决可用
set_time_limit(0)取消限制，但仅对 CLI 模式安全；Web 环境下取消后仍可能被 Web 服务器（如 Nginx 的fastcgi_read_timeout或 Apache 的Timeout）截断 - 更稳妥的做法是拆分操作：把“创建文件”变成“发起任务 + 异步完成”，例如用队列或后台进程
- 若必须同步完成，需同时调优 PHP 和 Web 服务器两层超时配置，且确保
set_time_limit()在文件操作前调用（它不作用于已超时的脚本）
用 fopen() + fwrite() 分块写入大文件，避免单次阻塞过久
直接 file_put_contents($path, $huge_data) 容易因内存占用高、IO 阻塞长而触发超时；换成流式分块写入，既能控内存，又能把总耗时摊薄到多次短操作中，降低被中断概率。
- 打开文件用
fopen($path, 'wb')，不要用'a'（追加模式在大文件上 seek 开销明显） - 每次
fwrite()控制在 64KB–1MB，太小增加系统调用开销，太大仍可能卡住 - 写完每块后可加
fflush($fp)强制刷盘（尤其日志类场景），但频繁刷盘会影响性能，按需启用 - 示例片段：
$fp = fopen($path, 'wb'); foreach (chunk_split($data, 512 * 1024, "\0") as $chunk) { fwrite($fp, $chunk); } fclose($fp);
Web 环境下创建文件超时，Nginx/Apache 配置常被忽略
即使 PHP 层面设了 set_time_limit(0)，Nginx 默认 fastcgi_read_timeout 60，Apache 默认 Timeout 300，都会在 PHP 还没写完时就关闭连接，导致前端看到 502/504，而 PHP 错误日志里却没超时记录。
- Nginx：在
location ~ \.php$块中加fastcgi_read_timeout 300;（单位秒），并确认fastcgi_send_timeout和fastcgi_connect_timeout也足够 - Apache：在虚拟主机或目录配置中加
Timeout 300，如使用 mod_php，还需检查php_value max_execution_time 300 - CLI 脚本不受 Web 服务器限制，但要注意
php.ini中max_execution_time是否为 0（CLI 默认是 0）
真正长时任务别硬扛超时，改用异步+状态轮询
用户点击“导出报表”后等 5 分钟？这体验本身就不合理。应把文件生成逻辑移到后台，前端只负责发起请求、轮询状态、最后跳转下载链接。
立即学习“PHP免费学习笔记（深入）”；
- 用 Redis 或数据库存任务状态（
pending/running/done/failed），键名带唯一任务 ID - Web 请求只写入任务，立即返回
{"task_id": "abc123"}；另起一个 CLI 脚本（或用 Supervisor 管理）监听并执行 - 前端用
setTimeout或fetch()轮询/api/task-status?task_id=abc123，拿到done后引导下载/download?task_id=abc123 - 注意清理机制：成功后删临时文件，失败后留日志，定时任务清理超时未完成项
超时不是靠堆时间解决的问题，关键在分清“谁在超时”——PHP？Web 服务器？还是前端 AJAX？每层都有对应开关，漏掉任意一层，都可能让前面所有调整白费。
