php -d memory_limit必须前置，因Composer是PHP进程，其内存上限由PHP启动时memory_limit锁定；-d参数须在PHP解析命令行阶段注入，否则被忽略或误作Composer选项。
php -d memory_limit=2G composer install 为什么必须加在最前面
因为 php 是真正启动进程的命令，-d 参数只对它启动的这个 PHP 进程生效。如果你直接写 composer install，系统会调用已安装的 shell wrapper（比如 /usr/local/bin/composer），它内部可能用的是默认 memory_limit 的 PHP，-d 就完全没机会传进去。
常见错误写法：composer install -d memory_limit=2G（参数被当成 composer 自己的选项，报错）或 php composer.phar -d memory_limit=2G install（-d 放错位置，PHP 不识别）。
- 正确顺序永远是：
php -d memory_limit=2G composer install或php -d memory_limit=2G ./composer.phar update - Windows PowerShell 中
-1必须加引号：php -d "memory_limit=-1" composer install - 用别名（如
alias composer="php composer.phar"）时，-d仍要放在php后面，别名本身不支持透传参数
COMPOSER_MEMORY_LIMIT 和 php -d memory_limit 哪个优先级高
COMPOSER_MEMORY_LIMIT 是 Composer 自己读取的环境变量，只控制 Composer 内部逻辑（比如依赖解析、autoload 生成）的内存分配；而 php -d memory_limit 是 PHP 底层进程限制，覆盖所有阶段，包括插件加载、脚本执行、甚至错误处理本身。
优先级顺序是：php -d memory_limit > COMPOSER_MEMORY_LIMIT > php.ini 中的 memory_limit。
- CI/CD 脚本里推荐用
php -d：明确、可控、不依赖环境变量是否被继承 - 本地开发想省事可设
COMPOSER_MEMORY_LIMIT=2G到~/.zshrc，但要注意某些 Docker 容器或受限 shell 可能不加载它 - 设
COMPOSER_MEMORY_LIMIT=-1不能绕过系统 OOM，php -d memory_limit=-1同样有风险，生产环境建议固定为2G或3G
vendor/autoload.php 生成失败也报内存不足，怎么排查
这不是 autoload 机制出问题，而是 dump-autoload 阶段扫描了不该扫的文件——比如 storage/logs/、node_modules/、巨型 JSON 配置、或被误加进 autoload 的目录。
先隔离问题：composer dump-autoload --no-scripts 单独运行，看是否还崩。如果不崩，说明是 post-autoload-dump 脚本在作祟。
- 检查
composer.json的autoload和autoload-dev，确认没包含"dist/"、"build/"、"logs/"等非 PHP 目录 - 运行
find . -name "*.php" -size +5M找出超大 PHP 文件（有些旧模板引擎会把整个 HTML 塞进 PHP 文件） - 临时删掉
vendor/外的tests/、docs/、examples/目录再试，排除干扰 - 如果用了
"optimize-autoloader": true，它会遍历所有匹配文件建 map，此时冗余文件影响更大
Docker 或 CI 环境下 composer install 失败但本地正常
根本区别不在 Composer 版本，而在 PHP CLI 的可用内存和容器总内存限制。GitHub Actions 默认 Ubuntu runner 总内存约 7GB，但 PHP 进程可能只分到几百 MB；Docker 容器若没设 --memory，会被宿主机 OOM killer 杀掉，错误日志却只显示 “Allowed memory size exhausted”。
不要假设 CI 环境和你本地一样——它通常禁用 php.ini 修改、不加载用户 shell 配置、且默认关闭 opcache/APCu。
- GitLab CI 示例：
php -d memory_limit=2G /usr/bin/composer install --no-interaction - GitHub Actions 若用
composer/setup-phpAction，必须显式传memory-limit: 2G，否则它默认用系统值 - Dockerfile 中除了
php -d，还得加docker build --memory=4g或docker run --memory=4g，否则 PHP 层面再放开也没用 - 避免在
.env或phpunit.xml里设PHP_MEMORY_LIMIT：Composer 不读这些
实际部署时最容易被忽略的一点：不是所有“内存不足”都该加内存。如果 composer install 在 CI 中反复失败，先 composer clear-cache 再试——损坏的缓存会导致 Composer 重复解压、校验、重建索引，比正常流程多耗 3 倍内存。
