答案是使用SSH密钥或GitHub Personal Access Token（PAT）配置Composer访问私有仓库。推荐根据环境选择：开发环境可用SSH密钥，通过ssh-keygen生成密钥并添加公钥到GitHub；CI/CD环境则推荐使用PAT，通过环境变量GITHUB_TOKEN传递认证信息，避免凭据泄露。
Composer要依赖私有GitHub包，核心在于让Composer获得访问这些私有仓库的权限。最常见且推荐的做法是使用SSH密钥或GitHub Personal Access Token (PAT)进行认证。这两种方式都能让Composer在执行
composer install
或
composer update
时，顺利拉取到你拥有权限的私有代码。
要让Composer能够顺利拉取私有的GitHub包，你需要配置好认证凭据。这里我们主要讨论两种主流且可靠的方案：SSH密钥和GitHub Personal Access Token。
方案一：使用SSH密钥这是许多开发者偏爱的方式，因为它与Git本身的认证机制高度兼容。
生成SSH密钥对（如果还没有的话）:如果你还没有SSH密钥，或者想为Composer专门生成一个，可以在终端运行：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
按照提示操作，通常会保存在
~/.ssh/id_rsa
和
~/.ssh/id_rsa.pub
。
将公钥添加到GitHub账户或组织:登录GitHub，进入
Settings -> SSH and GPG keys
，点击
New SSH key
，将
id_rsa.pub
文件的内容粘贴进去。如果你是在组织层面使用，也可以在组织设置中添加部署密钥（Deploy Key），但部署密钥通常只给单个仓库使用。对于多个私有包，账户级别的SSH密钥更方便。
配置Composer的Git客户端:Composer在内部会调用Git命令来克隆仓库。确保你的Git客户端配置了SSH。通常情况下，只要你的SSH代理（
ssh-agent
）运行着，并且私钥被正确添加，Composer就能自动利用SSH进行认证。你可以通过运行
ssh-add ~/.ssh/id_rsa
来添加私钥到
ssh-agent
。
在
composer.json
中指定仓库:在你的项目
composer.json
文件中，你需要明确告诉Composer你的私有包在哪里。
{ "name": "your-project/app", "description": "My main application", "type": "project", "require": { "php": "^8.0", "your-vendor/private-package": "^1.0" }, "repositories": [ { "type": "vcs", "url": "git@github.com:your-vendor/private-package.git" } ], "config": { "allow-plugins": { "php-http/discovery": true } }}
注意
"url": "git@github.com:your-vendor/private-package.git"
，这里使用的是SSH协议的Git URL。
GitHub Copilot
GitHub AI编程工具，实时编程建议
48 查看详情
方案二：使用GitHub Personal Access Token (PAT)当SSH不太方便，比如在CI/CD环境中，或者你不想管理SSH密钥时，PAT是个很好的替代方案。
生成Personal Access Token:登录GitHub，进入
Settings -> Developer settings -> Personal access tokens -> Tokens (classic)
（或者
Fine-grained tokens
，但classic更常用）。点击
Generate new token
，给它一个有意义的名字（例如”Composer for My Project”）。关键是权限（Scopes）： 至少需要勾选
repo
权限，以便Composer能够读取私有仓库。如果你的包需要发布到Packagist或者其他操作，可能还需要更多权限。生成后，请务必复制这个Token，因为它只会显示一次。
配置Composer使用PAT:你可以通过多种方式让Composer使用这个PAT：
全局配置（不推荐用于生产环境）:
composer config -g github-oauth.github.com
这会将Token保存在你的全局Composer配置中（通常是
~/.composer/config.json
）。在开发机上方便，但生产环境或共享环境不安全。
项目级别配置（推荐）:在你的项目根目录运行：
composer config github-oauth.github.com
这会将Token保存在项目
composer.json
同级的一个
auth.json
文件中。请务必将
auth.json
添加到
.gitignore
中，绝不能提交到版本控制！
// auth.json{ "github-oauth": { "github.com": "" }}
环境变量（CI/CD环境推荐）:在CI/CD管道中，你可以设置一个环境变量，例如
COMPOSER_AUTH
：
export COMPOSER_AUTH='{"github-oauth": {"github.com": ""}}'
或者更直接地，设置
GITHUB_TOKEN
环境变量（Composer 2.0+ 会自动识别）：
export GITHUB_TOKEN=
这是最安全和灵活的方式，因为Token不会持久化在文件系统中。
在
composer.json
中指定仓库:与SSH方式类似，但URL可以使用HTTPS协议。
{ "name": "your-project/app", "description": "My main application", "type": "project", "require": { "php": "^8.0", "your-vendor/private-package": "^1.0" }, "repositories": [ { "type": "vcs", "url": "https://github.com/your-vendor/private-package.git" } ]}
Composer会尝试使用配置的PAT来认证HTTPS请求。
如何选择SSH密钥还是Personal Access Token？哪种方式更适合我的场景？
选择SSH密钥还是
以上就是composer如何让项目依赖私有的GitHub包的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/261919.html
微信扫一扫 
支付宝扫一扫 
