解决 Laravel 开发服务器 300 秒自动停止问题-php教程-PHP中文网

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

聖光之護

发布： 2025-09-02 23:14:01

原创

543人浏览过

解决 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 进程（具体是 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 文件。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

在文件中搜索 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中文网其它相关文章！