使用 composer config --global repositories.xxx composer https://your-repo.com 命令将私有仓库添加到全局配置,使所有项目均可访问;2. 如需认证,通过 composer config --global http-basic 或 bearer-token 设置凭据,信息将存于 ~/.composer/auth.json;3. 运行 composer config --global --list 验证配置是否生效;4. 注意项目级配置会覆盖全局设置,团队协作建议在项目中显式声明仓库以保持一致性。

要在 Composer 中全局配置私有仓库,让所有项目都能访问该仓库中的包,可以通过修改全局的 config 文件来实现。这样就不用在每个项目的 composer.json 中重复添加仓库信息。
1. 使用命令行添加全局仓库
推荐使用config 命令将私有仓库写入全局配置文件。执行以下命令:
composer config --global repositories.your-repo-name composer https://your-private-repo.com说明:
-
--global 表示写入全局配置(通常是用户主目录下的
~/.composer/config.json) - repositories.your-repo-name 是你为该仓库起的别名,可自定义
- composer 表示仓库类型为 Composer 类型(支持 packages.json 的服务)
- https://your-private-repo.com 替换为你的私有仓库地址(如 Satis、Toran Proxy、Private Packagist 等)
composer config --global repositories.my-satis composer https://packages.example.com
2. 配置认证信息(如需要)
如果私有仓库需要身份验证,可以设置 HTTP 基本身份认证或 OAuth Token:composer config --global http-basic.your-private-repo.com username password或设置 bearer token:
composer config --global bearer-token.your-private-repo.com your-api-token-here这些信息会被保存在
auth.json 文件中(通常位于 ~/.composer/auth.json),Composer 在请求私有仓库时会自动带上认证头。
3. 查看全局配置是否生效
你可以通过以下命令查看当前全局配置:composer config --global --list或直接查看配置文件内容:
cat ~/.composer/config.json
cat ~/.composer/auth.json确认
repositories 和 http-basic / bearer-token 相关字段已正确写入。
4. 注意事项
- 全局仓库对所有本地项目生效,请确保仓库地址稳定可靠
- 若项目中有同名仓库配置,项目级配置会覆盖全局配置
- 团队协作时,建议通过项目级
composer.json明确声明依赖源,避免环境差异 - 私有仓库需支持 Composer 协议(提供
packages.json或符合 Composer 接口)
composer install 或 require 时,都会尝试从你配置的私有仓库拉取包。










