如何为你的Composer包配置GitHub Actions CI_自动化测试与发布Composer包到Packagist

配置 GitHub Actions 可实现 Composer 包的自动化测试与发布。1. 创建 test.yml 触发多 PHP 版本测试，确保代码质量；2. 在 Packagist 获取 API Token 并配置 GitHub Secrets，创建 publish.yml 使打 tag 时自动通知 Packagist 更新包；3. 可选在发布前加入测试和静态分析步骤，确保仅通过检查的版本被发布。完成配置后，即可实现提交自动测试、打标自动发布的 CI/CD 流程。

为你的 Composer 包配置 GitHub Actions，可以实现自动化测试和自动发布到 Packagist，不仅能提升开发效率，还能保证代码质量。下面一步步教你如何设置。

1. 配置 GitHub Actions 运行 PHP 测试

在项目根目录创建 .github/workflows/test.yml 文件，用于定义 CI 流程：

name: Test
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
php-version: ['8.1', '8.2', '8.3']
steps:
  - name: Checkout code
    uses: actions/checkout@v4

  - name: Setup PHP
    uses: shivammathur/setup-php@v2
    with:
      php-version: ${{ matrix.php-version }}
      tools: composer
      coverage: none

  - name: Install dependencies
    run: composer install --no-progress --no-suggest

  - name: Run tests
    run: composer test
这个工作流会在每次 push 或 PR 时运行，使用多个 PHP 版本执行测试。确保你的 composer.json 中有 test 脚本：
"scripts": {
    "test": "phpunit"
}
2. 设置自动发布到 Packagist
Packagist 支持通过 API 触发包的更新。你可以让 GitHub Actions 在你打 tag 时自动通知 Packagist。
先在 Packagist 获取你的 API Token（在账户设置中），然后在 GitHub 仓库的 Settings > Secrets and variables > Actions 中添加两个密钥：


PACKAGIST_USERNAME：你的 Packagist 用户名

PACKAGIST_API_TOKEN：你获取的 API Token

接着创建发布工作流文件：.github/workflows/publish.yml
name: Publish to Packagist
on:
push:
tags:
'v*'  # 推送以 v 开头的 tag，如 v1.0.0
jobs:
publish:
runs-on: ubuntu-latest
steps:
name: Notify Packagist
uses: "ramsey/composer-install@v2"
with:
composer-options: "--no-progress --no-suggest"
name: Trigger Packagist Update
run: |
curl -X POST \
-u ${{ secrets.PACKAGIST_USERNAME }}:${{ secrets.PACKAGIST_API_TOKEN }} \
https://www.php.cn/link/8ebef38fe0b242f7c7a87e7f5b2de305 \
-d "repository[url]=https://www.php.cn/link/536f4ea1075a3900f3791bf4097880fc${{ github.repository }}"
当你运行 git tag v1.0.0 && git push origin v1.0.0 时，GitHub Actions 会自动触发更新，Packagist 就会拉取最新代码并更新你的包信息。
3. 可选：自动发布前运行完整检查
为了防止有问题的版本被发布，可以在发布流程前加入测试和静态分析：
      - name: Checkout code
        uses: actions/checkout@v4
  - name: Setup PHP
    uses: shivammathur/setup-php@v2
    with:
      php-version: '8.3'
      tools: composer
这样能确保只有通过测试的 tag 才会触发发布。
基本上就这些。配置完成后，你的 Composer 包就有了完整的 CI/CD 流程：代码提交自动测试，打标签自动同步到 Packagist。不复杂但容易忽略细节，比如 tag 格式和密钥权限。