发布前必须移除或替换 path 仓库配置,否则 Packagist 无法解析、安装失败;Packagist 完全忽略 repositories 字段,只认 name+version+require;推荐用 composer.json.dist 作为发布基准并严格验证。

发布前必须手动移除或替换 path 仓库配置,否则 Packagist 无法解析、安装会失败——Composer 不会帮你“翻译”本地路径为远程包。
为什么 packagist.org 拒绝接受含 path 仓库的 composer.json
Packagist 只解析 require 中声明的包名与版本约束,完全忽略 repositories 字段。一旦你的 composer.json 里写了 "type": "path",Packagist 在抓取时会跳过该字段,但不会报错;真正出问题的是下游用户:composer install 时找不到 vendor/name,因为 Packagist 根本没把它当有效包注册。
常见错误现象:Could not find package vendor/name,但你确信已 push tag 并在 Packagist 上看到包页面——问题往往就出在你发布的 composer.json 里还残留着本地 repositories 配置。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- packagist.org 不读取、不执行、不验证
repositories,它只认name+version+require - CI 构建时若用
composer install --no-dev,path 仓库不会生效,但也不会报错,容易误以为“没问题” - 如果你用
composer archive打 zip 包发布,它默认不打包repositories,但若手动生成 dist,仍需检查源composer.json
发布前怎么安全替换 path 依赖为真实 Packagist 包
最可靠的做法不是“自动替换”,而是用两套配置隔离:开发态用 path,发布态用干净的 composer.json。不要依赖脚本正则替换——name 冲突、嵌套 JSON 结构、注释都会导致出错。
- 维护一个
composer.json.dist:不含repositories,require指向正式版(如"acme/utils": "^2.1"),作为发布基准 - CI 流程中,在打包前运行
cp composer.json.dist composer.json,再composer validate确保无误 - 本地开发仍用带
repositories的composer.json,但 gitignore 掉它,或用composer.json.local+git update-index --skip-worktree composer.json锁定主文件 - 绝对不要在
require-dev里写 path 依赖——dev 包同样会被 Packagist 忽略,且可能污染生产 autoload
私有包发布时 path 依赖的常见陷阱
如果你的包本身依赖另一个本地开发中的私有包(比如 acme/core ← acme/api),发布 acme/api 前,必须确认 acme/core 已发布到私有仓库(如 Satis、Private Packagist)并被正确索引。否则,即使你清掉了 path,composer install 仍会因无法解析 acme/core 而失败。
- 私有仓库 URL 必须可被所有下游环境访问(CI、Docker 构建机、生产服务器),不能是
http://localhost或内网地址 - 私有包的
composer.json中name必须与require中完全一致,包括大小写和短横线 - 使用
composer show acme/core验证私有仓库是否已被 Composer 正确识别(输出应含source和dist地址) - 若用 Satis,确保
require版本约束能匹配 Satis 生成的packages.json中实际存在的版本
真正麻烦的从来不是“怎么换”,而是“换完有没有人真去验证”。很多团队发布后才发现某条 require 指向了尚未打 tag 的 dev 分支,或者私有仓库证书过期——这些都不会在本地 composer install 时报错,只会在 CI 或新同事 clone 后爆发。

















