解决 Laravel 开发服务器 300 秒自动停止问题

当使用 php artisan serve 启动 laravel 开发服务器时，若遇到 300 秒后自动停止并报告“Maximum execution time exceeded”错误，通常是 php CLI 的 max_execution_time 配置限制所致。本文将指导您通过修改 php.ini 文件来延长或解除此限制，确保开发服务器稳定运行。

引言

laravel 的 php artisan serve 命令提供了一个轻量级的开发服务器，方便开发者快速启动项目进行调试。然而，部分用户可能会遇到开发服务器在运行约 300 秒（5 分钟）后突然停止，并抛出“maximum execution time of 300 seconds exceeded”的致命错误。尽管错误发生后，通过浏览器访问项目可能仍然正常，但这会给开发过程带来不便，因为 artisan serve 命令本身不再监控文件变化或提供实时日志输出。

这个问题的根本原因在于 php artisan serve 命令实际上是一个由 PHP CLI 进程启动并持续运行的脚本。PHP 默认对脚本的执行时间有限制，即 max_execution_time 配置项。当这个 CLI 进程（具体是 IlluminateFoundationconsoleServeCommand.php 中的循环）运行时间超过预设的 max_execution_time 时，PHP 就会强制终止该进程，从而导致开发服务器的“停止”。

问题现象与诊断

典型的错误输出如下所示：

Starting Laravel development server: http://127.0.0.1:8000 [Sun Oct 31 15:23:52 2021] PHP 7.4.25 Development Server (http://127.0.0.1:8000) started PHP Fatal error: Maximum execution time of 300 seconds exceeded in F:projectvendorlaravelframeworksrcIlluminateFoundationConsoleServeCommand.php on line 59  SymfonyComponentErrorHandlerErrorFatalError  Maximum execution time of 300 seconds exceeded  at F:projectvendorlaravelframeworksrcIlluminateFoundationConsoleServeCommand.php:59 55▕ : now()->addDays(30)->getTimestamp(); 56▕ 57▕ $process = $this->startProcess($hasEnvironment); 58▕ ➜ 59▕ while ($process->isRunning()) { 60▕ if ($hasEnvironment) { 61▕ clearstatcache(false, $environmentFile); 62▕ } 63▕

从错误信息中可以清晰地看到 Maximum execution time of 300 seconds exceeded，并且错误发生在 ServeCommand.php 的一个 while 循环中，这个循环负责保持开发服务器进程的运行和监控。这进一步证实了是 PHP CLI 的执行时间限制导致的问题。

解决方案：修改 PHP CLI 配置

解决此问题的核心是调整 PHP CLI 的 max_execution_time 配置。

1. 定位正确的 php.ini 文件

PHP 在不同环境下（例如 Web 服务器和命令行接口）可能使用不同的 php.ini 配置文件。我们需要修改的是用于 CLI 的 php.ini 文件。您可以通过在命令行中运行以下命令来查找 PHP CLI 当前使用的 php.ini 文件路径：

php --ini

该命令的输出会列出 PHP 扫描 php.ini 的路径以及实际加载的配置文件。例如：

Configuration File (php.ini) Path: C:php Loaded Configuration File:         C:phpphp.ini Scan for additional .ini files in: (none) Additional .ini files parsed:      (none)

请记下 Loaded Configuration File 对应的路径。

2. 编辑 php.ini 文件

使用文本编辑器（如 VS Code, notepad++, sublime Text 等）打开上一步找到的 php.ini 文件。

在文件中搜索 max_execution_time。您可能会找到类似下面的一行：

max_execution_time = 300

将其值修改为 0，表示无限制，或者一个足够大的数值（例如 3600 秒，即 1 小时）。对于开发环境，设置为 0 通常是安全的且推荐的做法，因为它允许 artisan serve 命令无限期运行。

max_execution_time = 0

保存 php.ini 文件。

3. 重启开发服务器

完成 php.ini 的修改并保存后，您需要关闭当前运行的 php artisan serve 进程（如果它还在运行），然后重新启动它：

php artisan serve

现在，您的 Laravel 开发服务器应该能够持续运行，不再受 300 秒执行时间限制的影响。

注意事项

• CLI 与 Web 服务器的 php.ini 区别： 务必确认您修改的是 PHP CLI 使用的 php.ini 文件，而不是您的 Web 服务器（如 nginx 或 apache）所使用的 php.ini。Web 服务器的 php.ini 通常位于不同的路径，并且修改其中的 max_execution_time 会影响所有 Web 请求的执行时间，这在生产环境中需要谨慎处理。对于 php artisan serve 而言，我们只关心 CLI 的配置。
• max_execution_time = 0 的含义： 将 max_execution_time 设置为 0 意味着 PHP 脚本可以无限期运行。在开发环境中，对于像 php artisan serve 这种需要长时间运行的 CLI 进程，这是一个合理且方便的设置。但在生产环境中，对于处理 Web 请求的 PHP 脚本，通常会设置一个合理的上限，以防止恶意或错误脚本长时间占用服务器资源。
• 环境差异： 不同操作系统或 PHP 安装方式（如 XAMPP, WAMP, MAMP, docker, Homebrew 等）可能会导致 php.ini 的位置有所不同。始终通过 php –ini 命令来定位是最可靠的方法。

总结

当 Laravel 开发服务器在 300 秒后自动停止时，这通常是 PHP CLI 的 max_execution_time 配置限制所导致。通过简单地定位并修改 PHP CLI 的 php.ini 文件中的 max_execution_time 配置项，将其值设置为 0 或一个更大的数值，即可彻底解决此问题，确保您的开发服务器能够稳定、持续地运行，为您的 Laravel 开发工作提供一个顺畅的环境。

以上就是解决 Laravel 开发服务器 300 秒自动停止问题的详细内容，更多请关注php中文网其它相关文章！