PHP CLI的memory_limit是硬性闸门，Composer启动时即受其限制，超限直接Fatal error中止；即使设了composer config --global memory-limit -1也无效，因PHP层限制优先级更高；大型项目install峰值达1.2–1.8GB，远超默认128M/256M；-1可能仍失败，因Docker cgroup、xdebug或共享主机屏蔽等外部限制；update比install内存消耗高3–5倍，应严格避免在线执行。
PHP CLI 的 memory_limit 是硬性闸门，不是建议值
Composer 启动后第一件事是加载 PHP 解析器，而 memory_limit 是 PHP 进程启动时就锁定的内存上限。一旦 Composer 在 autoload 生成、依赖图展开或 lock 文件校验阶段申请内存超过这个值，PHP 直接抛出 Fatal error: Allowed memory size of XXX bytes exhausted 并中止进程——它不会降级、不会重试、不写日志，就是立刻死。
常见错误现象：
- 执行
composer install卡在Loading composer repositories或Resolving dependencies阶段几秒后退出，终端只显示一行报错 - CI 日志里没明显错误，但 exit code = 137 —— 这是 Linux OOM killer 杀掉进程的信号，本质还是内存不够
注意：这个限制和 Composer 自己的 memory-limit 配置无关。即使你运行过 composer config --global memory-limit -1，只要 PHP 层的 memory_limit 是 128M，Composer 根本没机会读到那条配置就崩了。
大型框架项目的真实内存需求远超默认值
ThinkPHP 6 全量解析依赖树、Laravel 10 + Symfony 组件 + dev 工具链（PHPStan、PHPUnit、Pest）组合下，composer install 内存峰值常达 1.2–1.8GB。而 PHP CLI 默认 memory_limit 多为 128M 或 256M，连依赖图的根节点都加载不完。
实操判断方式：
- 查当前 CLI 使用的限制：
php -r "echo ini_get('memory_limit');" - 确认配置文件路径：
php --ini，重点看Loaded Configuration File是否为空或指向非预期文件 - Windows 下用 CMD 查可能漏结果，必须用 PowerShell 运行
php -i | findstr "memory_limit"
为什么设成 -1 有时也不起作用
php -d memory_limit=-1 确实能解除 PHP 层限制，但实际仍可能失败，原因不在 PHP：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Docker 容器被 cgroup 限了总内存（比如
--memory=2g），即使 PHP 说“不限”，系统一到上限就 kill 进程 - 共享主机屏蔽了
-d参数，或强制设死memory_limit=128M（无法覆盖） - 启用了
xdebug：开发环境开着它会让 Composer 内存占用翻倍，php -d zend_extension= -d xdebug.mode=off composer install才算真正“关掉”
这时候不能只盯着 Composer，得看整个执行链路：PHP 进程 → 宿主资源 → 扩展干扰。
install 和 update 的内存消耗根本不在一个量级
composer install 只按 composer.lock 精确还原，内存消耗稳定；composer update 要重跑 SAT 求解、遍历所有版本约束、下载元数据、反复回溯冲突，是典型的 CPU + 内存双密集型操作。
容易踩的坑：
- 在 CI 里写
composer update而不是composer install—— 尤其当composer.lock已提交，完全没必要 - 本地没清缓存就跑 update，损坏的
~/.composer/cache会触发异常内存分配 - 加了
--no-dev对 install 有效，但对 update 效果有限：dev 依赖虽不装，但版本解析阶段仍要参与计算
真正省内存的做法是：开发机完成 composer update → 提交 composer.lock → 服务器只跑 composer install --no-dev。
最常被忽略的一点：内存问题往往不是孤立发生的。它和 xdebug 开关、Docker cgroup 限制、PHP 配置文件路径混乱、甚至 Git Bash 对 -d 参数的解析缺陷，全串在一起。单盯 memory_limit 很容易绕进死胡同。
