本文介绍在 laravel 中配置路由以避免“最大执行时间超出”错误,通过设置 `max_execution_time` 为 0 实现长期运行任务,同时强调其适用场景与关键注意事项。
在 Laravel 应用中,若需实现一个持续运行、不主动终止的后台服务(例如长轮询监听、简易守护进程或调试用的无限循环),直接在 Web 路由中使用 while(true) + sleep() 并调用 curl 访问该路由,极易触发 PHP 的默认执行时间限制(通常为 30 或 60 秒),导致返回 Fatal error: Maximum execution time of X seconds exceeded。
✅ 正确做法是:在路由处理逻辑的最开始显式禁用执行时间限制:
// routes/web.php 或控制器方法中
Route::get('/running-service', function () {
// 禁用 PHP 执行时间限制(0 表示无限制)
ini_set('max_execution_time', '0');
// 可选:关闭输出缓冲,避免响应卡住
if (ob_get_level()) {
ob_end_clean();
}
// 模拟长期运行逻辑(如监听队列、轮询外部状态等)
while (true) {
\Log::info('Service is running...', ['timestamp' => now()]);
// 关键:必须加入可控暂停,否则 CPU 占用 100%
sleep(5); // 每 5 秒执行一次,可根据实际需求调整
// ✅ 强烈建议添加退出条件(如检查文件、数据库标记或信号)
// 例如:if (file_exists(storage_path('RUNNING_OFF'))) break;
}
});
⚠️ 重要注意事项: