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

技术教程
2025-12-03 16:03:13

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

如何为你的composer包配置github actions ci_自动化测试与发布composer包到packagist

为你的 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 中添加两个密钥：

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 格式和密钥权限。

以上就是如何为你的Composer包配置GitHub Actions CI_自动化测试与发布Composer包到Packagist的详细内容，更多请关注php中文网其它相关文章！