答案是使用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本身的认证机制高度兼容。

1. 生成SSH密钥对（如果还没有的话）: 如果你还没有SSH密钥，或者想为Composer专门生成一个，可以在终端运行：

   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

   按照提示操作，通常会保存在

   ~/.ssh/id_rsa

   和

   ~/.ssh/id_rsa.pub

   。

2. 将公钥添加到GitHub账户或组织: 登录GitHub，进入

   Settings -> SSH and GPG keys

   ，点击

   New SSH key

   ，将

   id_rsa.pub

   文件的内容粘贴进去。如果你是在组织层面使用，也可以在组织设置中添加部署密钥（Deploy Key），但部署密钥通常只给单个仓库使用。对于多个私有包，账户级别的SSH密钥更方便。

3. 配置Composer的Git客户端: Composer在内部会调用Git命令来克隆仓库。确保你的Git客户端配置了SSH。通常情况下，只要你的SSH代理（

   ssh-agent

   ）运行着，并且私钥被正确添加，Composer就能自动利用SSH进行认证。 你可以通过运行

   ssh-add ~/.ssh/id_rsa

   来添加私钥到

   ssh-agent

   。

4. 在

   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。
   

   从 Git 仓库历史中彻底删除文件

   |Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

   下载

方案二：使用GitHub Personal Access Token (PAT) 当SSH不太方便，比如在CI/CD环境中，或者你不想管理SSH密钥时，PAT是个很好的替代方案。

1. 生成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，因为它只会显示一次。

2. 配置Composer使用PAT: 你可以通过多种方式让Composer使用这个PAT：

   • 全局配置（不推荐用于生产环境）:

     composer config -g github-oauth.github.com <YOUR_GITHUB_TOKEN>

     这会将Token保存在你的全局Composer配置中（通常是

     ~/.composer/config.json

     ）。在开发机上方便，但生产环境或共享环境不安全。

   • 项目级别配置（推荐）: 在你的项目根目录运行：

     composer config github-oauth.github.com <YOUR_GITHUB_TOKEN>

     这会将Token保存在项目

     composer.json

     同级的一个

     auth.json

     文件中。请务必将

     auth.json

     添加到

     .gitignore

     中，绝不能提交到版本控制！

     // auth.json
     {
         "github-oauth": {
             "github.com": "<YOUR_GITHUB_TOKEN>"
         }
     }

   • 环境变量（CI/CD环境推荐）: 在CI/CD管道中，你可以设置一个环境变量，例如

     COMPOSER_AUTH

     ：

     export COMPOSER_AUTH='{"github-oauth": {"github.com": "<YOUR_GITHUB_TOKEN>"}}'

     或者更直接地，设置

     GITHUB_TOKEN

     环境变量（Composer 2.0+ 会自动识别）：

     export GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>

     这是最安全和灵活的方式，因为Token不会持久化在文件系统中。

3. 在

   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密钥还是