私有源元数据必须备份 composer.json 和 composer.lock,而非仅 vendor 目录;二者共同声明依赖内容与精确版本、校验和、私有源地址及配置,配合项目级 auth.json 才能确保可重现安装。

私有源元数据必须备份 composer.json + composer.lock,不是 vendor
只备份 vendor 目录等于没备份。它只是构建产物,可能被本地修改、忽略 Git、或因缓存/权限不一致;而 composer.json 声明“要什么”,composer.lock 记录“实际装了什么”——包括每个私有包的 exact commit hash、dist shasum、完整依赖树。生产回滚时,靠的是 lock 文件里的校验和与版本锁定,不是某次 rsync 过去的文件夹。
常见错误:CI 构建后只打包 vendor 上传,却没存下对应时间点的 composer.lock。一旦私有仓库临时不可用或分支被 force push,重装就会失败或装错版本。
-
composer.lock里包含私有包的完整下载 URL(如https://gitlab.example.com/myorg/utils.git)和 dist shasum,缺失它就无法验证 ZIP 包完整性 - 私有源配置(如
repositories数组中的type: "composer"地址)只存在于composer.json,不备份就丢失上下文 - 命名必须带环境+时间戳:例如
releases/prod-20261104-0925-composer.lock,禁用latest.lock或before-deploy.json这类模糊名
私有源配置本身要作为元数据一并归档
私有源地址、type 类型、认证方式这些不是“运行时配置”,而是项目元数据的一部分,必须随代码一起版本化或归档。否则换机器、重装 Composer 后,composer install 会直接 fallback 到 packagist.org,导致拉到同名但不相关的公有包。
验证当前生效的私有源配置,别信注释或记忆:
- 运行
composer config repositories查看当前项目实际加载的repositories数组顺序 - 确认私有源是否在第一位,且末尾有独立项
{"packagist.org": false}(拼错一个字符就无效) - 检查
type字段:私有 Packagist 类服务必须是"type": "composer",写成"git"或漏掉该字段,整条配置被跳过
auth.json 不是“密码文件”,是元数据链关键一环
auth.json 里存的是访问私有源所需的凭证(如 GitHub Token、GitLab Personal Access Token),它和 composer.json 是绑定关系。备份时不能只留一份全局 ~/.composer/auth.json,因为不同项目可能用不同 Token、不同 scope 权限。
推荐做法是项目级 auth.json(放在项目根目录),配合 CI 注入:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- CI 脚本中用
echo "$COMPOSER_AUTH" > auth.json动态生成,避免硬编码 - Token 必须含对应权限:GitHub 需
read:packages,GitLab 需apiscope;过期或权限不足会导致401 Unauthorized或403 Forbidden - 备份时把项目级
auth.json和composer.json放同一目录归档,但提交前确保已从 Git 忽略(.gitignore加auth.json)
备份动作必须集成进发布脚本,不能人工操作
人工执行 cp composer.{json,lock} ... 容易遗漏、命名出错、时间戳不准。所有备份应由 deploy.sh 或 CI 流水线自动完成。
示例安全备份命令(放入发布流程开头):
cp composer.{json,lock} releases/prod-$(date +%Y%m%d-%H%M)-composer.{json,lock}
这条命令同时保证:文件名带精确时间戳、composer.json 和 composer.lock 成对出现、路径明确可追溯。如果项目还用了项目级 auth.json,也应同步复制:
cp auth.json releases/prod-$(date +%Y%m%d-%H%M)-auth.json- CI 中需先校验
composer validate --no-check-all和composer install --dry-run是否通过,再触发备份
最常被忽略的一点:备份不是“存下来就行”,而是要能被快速定位、验证、还原。时间戳格式、路径层级、文件命名规则,必须全团队统一,否则故障时翻日志都找不到那版 lock 文件在哪。










