Composer导出文件(如composer export --format=lock)仅为只读快照,不含vendor-dir、repositories、auth凭据等运行时配置,无法直接导入或驱动安装,仅用于验证或diff对比。

Composer 的导出配置不能直接“导入”——它本质是生成一份只读快照,不是可逆的配置文件。真正要复用的是 vendor 路径、源仓库、认证凭据等运行时配置,这些靠 config.json 管理,而非导出结果。
composer export 生成的文件到底是什么
执行 composer export(如 composer export --format=lock)输出的是一个精简版 composer.lock,只含生产依赖的 name/version/source/reference。它不包含任何配置项(比如 vendor-dir、repositories、http-basic),也不带执行逻辑。
常见误解:把 deps-prod.txt 或 composer-prod.lock 当成“配置包”上传到新环境后试图“导入”,结果发现 composer install 报错找不到包或认证失败——因为导出文件根本不携带这些信息。
- 导出文件没有
config段,所以不会影响 vendor 路径、缓存位置或镜像源 - 导出文件不保存私有仓库的
http-basic凭据,新机器没配就拉不到包 - 导出文件不包含
platform设置(如 PHP 版本模拟),跨环境可能装错扩展兼容版本
共享 vendor 目录必须改 config.json,不是靠导出
想让多个项目共用一个 vendor 目录,唯一可靠方式是统一配置 COMPOSER_HOME + 全局 config.json,而不是靠导出再导入。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 在所有目标机器上设环境变量:
COMPOSER_HOME="/opt/composer-global"(Linux/macOS)或set COMPOSER_HOME=C:\composer-global(Windows) - 在
/opt/composer-global/config.json中写入:{"config": {"vendor-dir": "/srv/shared-vendor"}} - 确认该路径对 web 用户和 CLI 用户都具有读写权限(尤其共享主机上容易因用户隔离失败)
- 别把
vendor-dir写进项目级composer.json—— 它会被 Composer 忽略,白写
私有源和认证凭据怎么跨机器同步
私有 Git 仓库、Packagist 私有实例的登录信息,存在 COMPOSER_HOME/auth.json,不是导出内容的一部分。手动同步它比导出更关键。
-
auth.json格式示例:{"http-basic": {"gitlab.example.com": {"username": "deploy", "password": "token_xxx"}}} - 该文件必须和
config.json放在同一COMPOSER_HOME目录下才生效 - 不要硬编码密码到项目
composer.json;也不要把它提交进 Git(加进.gitignore) - 若用 CI/CD,建议通过 secret 注入环境变量
COMPOSER_AUTH,值为 JSON 字符串,Composer 会自动解析
导出清单只能验证,不能驱动安装
你导出的 topthink/framework 6.1.8 这类文本,唯一安全用途是人工核对或 CI 脚本断言,不能直接喂给 composer require 或触发安装。
- 想按清单重装?得先确保
composer.json和composer.lock已同步,再跑composer install --no-dev --optimize-autoloader - 如果只是想快速检查某台机器是否装了指定版本,用
composer show topthink/framework --locked更准,它读 lock 而非 vendor - 导出的
--format=lock文件可用于diff -u对比不同环境的依赖一致性,但不能当配置源用
最容易被忽略的一点:导出行为本身不校验网络可达性或权限,它只是序列化当前 lock 文件。如果 lock 里记录的是已删除的私有包 commit hash,导出再分发也没用——得先确保原始环境能成功 composer install。










