配置 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
<p>on: [push, pull_request]</p><p>jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
php-version: ['8.1', '8.2', '8.3']</p><pre class='brush:php;toolbar:false;'>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 中添加两个密钥：
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
- PACKAGIST_USERNAME：你的 Packagist 用户名
- PACKAGIST_API_TOKEN：你获取的 API Token
接着创建发布工作流文件：.github/workflows/publish.yml
name: Publish to Packagist
<p>on:
push:
tags:</p><ul><li>'v*' # 推送以 v 开头的 tag，如 v1.0.0</li></ul><p>jobs:
publish:
runs-on: ubuntu-latest
steps:</p><ul><li>name: Notify Packagist
uses: "ramsey/composer-install@v2"
with:
composer-options: "--no-progress --no-suggest"</li><li>name: Trigger Packagist Update
run: |
curl -X POST \
-u ${{ secrets.PACKAGIST_USERNAME }}:${{ secrets.PACKAGIST_API_TOKEN }} \
<a href="https://www.php.cn/link/8ebef38fe0b242f7c7a87e7f5b2de305">https://www.php.cn/link/8ebef38fe0b242f7c7a87e7f5b2de305</a> \
-d "repository[url]=<a href="https://www.php.cn/link/536f4ea1075a3900f3791bf4097880fc">https://www.php.cn/link/536f4ea1075a3900f3791bf4097880fc</a>${{ github.repository }}"当你运行 git tag v1.0.0 && git push origin v1.0.0 时，GitHub Actions 会自动触发更新，Packagist 就会拉取最新代码并更新你的包信息。
3. 可选：自动发布前运行完整检查
为了防止有问题的版本被发布，可以在发布流程前加入测试和静态分析：
- name: Checkout code
uses: actions/checkout@v4
<pre class='brush:php;toolbar:false;'> - name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
tools: composer这样能确保只有通过测试的 tag 才会触发发布。
基本上就这些。配置完成后，你的 Composer 包就有了完整的 CI/CD 流程：代码提交自动测试，打标签自动同步到 Packagist。不复杂但容易忽略细节，比如 tag 格式和密钥权限。
