换国内镜像源是必须做的第一步,需执行 composer config -g repo.packagist '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}',键名、type值、URL末尾斜杠缺一不可。

换国内镜像源是必须做的第一步,不是“试试看”,不换源其他优化基本无效。
确认并正确配置国内镜像源
执行 composer config -g repo.packagist,输出必须是完整 JSON:{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。缺一不可:键名是 repo.packagist(单数)、type 值必须显式写 composer、URL 末尾必须带 /。
常见错误包括:
- 用
composer config -g repos.packagist(复数repos)——旧版才认,新版静默失败 - 只写 URL 不带
composer类型:composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 配置无效 - URL 少了末尾斜杠,导致请求拼成
https://mirrors.aliyun.com/composerp2/foo.json→ 404
验证是否真走镜像:加 -vvv 运行 composer require foo/bar,日志里看到 GET https://mirrors.aliyun.com/composer/p2/... 才算生效。
避免重复解析依赖图
composer require 默认会重新计算整个依赖图,尤其在已有 composer.lock 时没必要。它比 install 更重,容易卡在 Resolving dependencies 阶段。
可选策略:
- 先删掉
vendor/和composer.lock,再用composer install --no-dev --prefer-dist拉取干净环境(适合 CI 或部署) - 若只是加一个包且 lock 文件可靠,改用
composer require foo/bar --no-update,再手动composer update foo/bar --with-dependencies缩小范围 - 确保没启用
xdebug:运行php -v看是否含xdebug,有则临时禁用:php -d xdebug.mode=off $(which composer) require foo/bar
调整 PHP 运行时与 Composer 参数
内存不足和并发限制是隐形杀手。默认 memory_limit=128M 在复杂依赖下极易触发重试或崩溃。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 临时提内存:
COMPOSER_MEMORY_LIMIT=-1 composer require foo/bar - 提升下载并发数(Composer 2.2+):
composer config -g http-max-concurrent-downloads 10(parallel-downloads已弃用) - 跳过自动加载器生成(如非首次安装):
composer require foo/bar --no-autoloader - 禁用脚本和开发依赖:
composer require foo/bar --no-scripts --no-dev
注意:--no-autoloader 后需手动 composer dump-autoload -o,否则新类可能无法加载。
生产环境应优先用 install 而非 require
require 是开发态命令,会修改 composer.json 并重算依赖;生产部署应锁定版本,靠 install 复现。
真正需要 require 的场景其实很少:
- 本地开发中加新依赖
- CI 中动态注入调试工具(如
phpunit),但应限定在--dev且用--no-scripts
如果发现 require 在服务器上频繁执行,大概率是流程设计反模式——应该把依赖变更控制在开发机,提交 composer.lock 后统一 install。
最易被忽略的一点:镜像只加速下载,不解决依赖解析慢。一旦卡在 Resolving dependencies,问题一定出在本地 PHP 配置、xdebug、platform 不匹配或 lock 文件残留,跟网络无关。










