必须用私有仓库并显式禁用packagist.org,因国内镜像仅为只读缓存、不含私有包且无权限隔离;Composer默认仍回退查询packagist.org,未设"packagist.org": false则私有包无法匹配。

必须用私有仓库 + 显式禁用 packagist.org,光配镜像或代理都不安全。
为什么不能只配国内镜像
阿里云、腾讯云等镜像只是 Packagist 的只读缓存,不包含你公司的私有包;它们也不做权限隔离,任何能访问镜像的人理论上都能看到你同步过去的包(如果镜像配置不当)。更关键的是:Composer 默认仍会查 packagist.org,哪怕你写了镜像 URL,只要没显式关掉它,私有包就永远匹配不上。
- 现象:composer install 能装公开包,但始终找不到
your-company/internal-sdk - 原因:
"packagist.org": false没加在composer.json顶层,或者加在了repositories里面(无效位置) - 验证:运行
composer config -l | grep "packagist\.org",输出应为packagist.org: false,不是空、不是true、也不是嵌套结构
私有仓库 URL 必须带末尾斜杠且用 HTTPS
内网部署的 Satis 或 Nexus Composer 仓库,URL 格式错一个字符就会 404 或静默 fallback 到官方源。Composer 会把 /packages.json 拼到你给的 URL 后面,所以结尾缺 / 就变成 https://repo.internal.compackages.json —— 明显错误。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 正确写法:
"url": "https://repo.internal.com/"(注意结尾/) - 错误写法:
"url": "https://repo.internal.com"、"url": "http://repo.internal.com/"(HTTP 会被 Composer 2.2+ 拒绝) - 公司用自签名证书?必须让 PHP 的 OpenSSL 信任它,否则
curl_setopt(): SSL certificate problem会直接中断,不是超时
项目级配置要清理 vendor 和 lock 文件
改完 composer.json 后直接 composer install,大概率失败。因为旧 composer.lock 里记录的是从 packagist.org 下载的包哈希,而新源返回的 ZIP 内容哪怕完全一样,URL 不同也会导致校验失败。
- 必须执行:
rm -rf vendor composer.lock(Windows 用rd /s/q vendor & del composer.lock) - 再跑:
composer install --no-cache(避免本地缓存干扰) - 如果用了 CI/CD,确保构建脚本也包含清理步骤,否则每次都会复现旧 lock 文件的问题
NTLM 代理环境必须走本地中转
公司 Windows 域环境下,http-proxy 配了也白配——Composer 原生不支持 NTLM 认证,设了只会返回 407 Proxy Authentication Required。这时候不能硬改 Composer 配置,得靠 cntlm 或 px 在本地起一个 HTTP 代理,让它处理 NTLM,再让 Composer 连 http://127.0.0.1:3128。
- 验证中转是否生效:
curl -x http://127.0.0.1:3128 -I https://repo.internal.com/packages.json,成功才说明链路通 - Composer 配置只写:
composer config -g repo.packagist.org.proxy http://127.0.0.1:3128和composer config -g repo.packagist.org.ssl-proxy http://127.0.0.1:3128 - 别碰
HTTP_PROXY环境变量,Composer 明确忽略它
真正卡住的地方往往不是“怎么连”,而是“连上之后 Composer 还去哪找包”——它默认信任 packagist.org,除非你亲手把它关掉,并告诉它:“只信这个内网地址”。漏掉这一步,所有配置都只是徒劳。

















