Laragon下Laravel内存不足需调高PHP CLI的memory_limit至512M,禁用Xdebug,并用php -d memory_limit=1G执行Composer命令。

Laragon 是 Windows 下轻量级本地开发环境,集成 Apache、MySQL、PHP 和 Redis。它默认的 PHP 配置(尤其是 CLI 模式)内存限制偏低(常为 128M),而 Laravel 项目在 composer install 或 php artisan 命令执行时,容易因依赖解析、配置加载、缓存生成等环节触发“Allowed memory size exhausted”错误。
核心不是 Laragon 本身有问题,而是它的 PHP CLI 配置未适配 Laravel 的现代构建需求。解决重点在于精准提升 PHP CLI 内存上限,并确保 Composer 使用的是该配置。
✅ 修改 Laragon 的 PHP CLI 内存限制(最直接有效)
Laragon 的 PHP 配置文件路径通常为:C:\laragon\etc\php\php.ini(对应你当前启用的 PHP 版本,如 php-8.3.0 文件夹下)
用记事本或 VS Code 打开该
php.ini文件搜索
memory_limit-
找到这一行(通常在
[PHP]段落中):memory_limit = 128M
-
改为(推荐起步值,兼顾安全与可用性):
memory_limit = 512M
⚠️ 不建议设为
-1(无限制),尤其在 CI 或多项目共存环境下;512M 足够支撑 Laravel 11/13 的composer install和常规artisan命令。 保存文件
-
重启 Laragon(点击系统托盘图标 → Restart All),确保新配置生效
Laravel Cloud下载Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
验证是否生效:
在 Laragon 终端(或 CMD/PowerShell 中进入 C:\laragon\bin\php\php-{version} 目录)运行:
php -r "echo ini_get('memory_limit');"
应输出 512M
✅ 运行 Composer 时临时加内存(升级/安装卡顿时首选)
即使改了 php.ini,有时 Composer 仍会沿用旧缓存或受环境变量干扰。此时用命令行参数强制指定更可靠:
php -d memory_limit=1G composer install
或升级时:
php -d memory_limit=1G composer update "laravel/framework:^13.0"
✅ Windows PowerShell 用户注意:需加引号
php -d "memory_limit=1G" composer install
✅ 检查并禁用 Xdebug(常被忽略的元凶)
Laragon 默认可能启用 Xdebug(尤其在“PHP Extensions”面板中勾选了)。Xdebug 会显著放大内存占用——哪怕只是 composer install,也可能让内存峰值翻 2–3 倍。
- 打开 Laragon 主界面 → Menu → PHP → PHP Extensions
-
取消勾选
xdebug(除非你正在调试且明确需要) - 点击 Restart All
验证是否已禁用:
php -v
输出中不应出现 with Xdebug 字样。
✅ 补充建议:避免缓存干扰 & 精简操作
- 清理 Composer 全局缓存(减少解析负担):
composer clear-cache
- 安装 Laravel 时跳过开发依赖(非必须可省):
php -d memory_limit=1G composer create-project laravel/laravel myapp --no-dev
- 新项目首次运行
php artisan config:cache前,确认.env已配置正确,避免因配置错误反复重试耗尽内存。
不复杂但容易忽略










