配置私有仓库需在composer.json中添加repositories指向私有地址，如Git仓库；通过composer config设置http-basic或SSH密钥认证，凭据存于auth.json避免明文泄露；随后可像公共包一样require私有包，CI/CD中结合环境变量自动注入令牌完成认证安装。
Composer 可以通过配置访问私有仓库和私有包，确保你在项目中安全地使用内部开发的 PHP 包。关键在于正确设置 repositories 和 authentication 信息。
配置私有仓库地址
在项目的 composer.json 文件中添加自定义仓库，告诉 Composer 到哪里拉取私有包。
支持的仓库类型包括：
- git：基于 Git 的 VCS（版本控制系统）仓库
- path：本地文件路径（适合开发环境）
- package：直接定义单个包信息
- private packagist：如 Satis、Private Packagist 等私有包服务器
示例：使用 Git 私有仓库
{ "repositories": [ { "type": "vcs", "url": "https://github.com/your-company/private-package" } ] }
这样 Composer 就知道从这个地址查找包，即使它不在 Packagist 上。
提供认证凭据
私有仓库通常需要身份验证。Composer 支持多种方式存储凭证，避免明文写在 composer.json 中。
常用方法：
- HTTP Basic 认证：适用于 HTTPS 地址的 Git 仓库
- SSH 密钥：推荐用于 Git，无需每次输入密码
- OAuth Token：GitHub/GitLab 推荐使用 Personal Access Token
将凭据写入 Composer 的全局配置文件（推荐）：
composer config --global http-basic.github.com username token
或通过交互式命令设置：
composer config http-basic.your-git-domain.com username password
配置后，凭证会保存在用户目录下的 auth.json 文件中（如 ~/.config/composer/auth.json），不会提交到代码库。
使用私有包作为依赖
一旦仓库配置完成，就可以像使用公开包一样 require 私有包。
composer require your-company/private-package:dev-main
Composer 会：
- 查询你配置的私有仓库
- 使用 auth.json 中的凭据进行认证
- 下载并安装包到 vendor 目录
只要你的账号有权限访问该仓库，安装就会成功。
自动化部署中的处理建议
在 CI/CD 或生产环境中，不能手动输入凭据。解决方案：
- 使用 SSH 部署密钥 并配置 agent 转发
- 在构建脚本中动态生成 auth.json
- 利用环境变量注入令牌（如 GitHub Actions Secrets）
例如在 GitHub Actions 中：
- name: Install dependencies run: | composer config http-basic.github.com ${{ secrets.GH_USER }} ${{ secrets.GH_TOKEN }} composer install
基本上就这些。只要仓库可访问且认证正确，Composer 处理私有包和公共包没有本质区别。关键是把配置做对，安全地管理好凭据。不复杂但容易忽略细节。
以上就是Composer如何处理私有仓库和私有包的详细内容，更多请关注php word js git json composer github access ai 环境变量 gitlab php composer json require Token private github git gitlab http https ssh 自动化 Access