引言
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 进程（具体是 Illuminate\Foundation\Console\ServeCommand.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:\project\vendor\laravel\framework\src\Illuminate\Foundation\Console\ServeCommand.php on line 59
Symfony\Component\ErrorHandler\Error\FatalError
Maximum execution time of 300 seconds exceeded
at F:\project\vendor\laravel\framework\src\Illuminate\Foundation\Console\ServeCommand.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:\php\php.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 开发工作提供一个顺畅的环境。
