PHP项目上线前如何做自动化测试

本文目录导读：

1. 分层测试策略（从左到右，成本递增，反馈递减）
2. 具体工具选择与配置
3. CI/CD 集成（以 GitHub Actions 为例）
4. 关键里程碑与最佳实践
5. 针对不同框架的快速启动命令
6. 常见问题与解决方案
7. 上线前必须通过的最低质量门禁

为 PHP 项目上线前搭建自动化测试体系，核心目标是在代码合并前或部署前快速发现回归问题、逻辑错误和性能瓶颈，以下是分步骤、分层次的实施指南，涵盖环境、工具链和具体操作。

分层测试策略（从左到右，成本递增，反馈递减）

具体工具选择与配置

静态分析（防止部署后出现 TypeError、undefined 方法）

• PHPStan：推荐 level max（目前是 9 或 10），或者至少 level 6。
• 配置示例 (phpstan.neon)：

  parameters:
      level: 9
      paths:
          - src/
          - tests/
      excludePaths:
          - vendor/

• 运行命令：vendor/bin/phpstan analyse

单元测试与集成测试

• PHPUnit：行业标准。

• 关键配置 (phpunit.xml)：

  <!-- 开启代码覆盖率，但 CI 中可关闭以加速 -->
  <phpunit bootstrap="vendor/autoload.php" colors="true"
           cacheResult="false" processIsolation="false">
      <testsuites>
          <testsuite name="Unit">
              <directory>tests/Unit</directory>
          </testsuite>
          <testsuite name="Feature">
              <directory>tests/Feature</directory>
          </testsuite>
      </testsuites>
      <coverage>
          <include>
              <directory suffix=".php">app/</directory>
          </include>
      </coverage>
  </phpunit>

• 数据库测试：使用 RefreshDatabase trait 或 Testcontainer（推荐后者，速度更快且不依赖本地环境）。

  // 使用 Laravel 的 RefreshDatabase 示例
  use Illuminate\Foundation\Testing\RefreshDatabase;
  class UserTest extends TestCase
  {
      use RefreshDatabase;
      public function test_can_create_user()
      {
          $user = User::factory()->create();
          $this->assertDatabaseHas('users', ['email' => $user->email]);
      }
  }

• Mock 外部依赖：用 Mockery 或 PHPUnit 内置的 createMock 模拟 HTTP 请求、邮件服务等。

端到端测试（E2E）

• 工具：Playwright（推荐，现代、跨浏览器、录制回放方便）。

• 示例 (使用 PHP 调用 Node 运行，或直接 Node 脚本)：

  // tests/e2e/login.spec.js
  const { test, expect } = require('@playwright/test');
  test('用户应该能成功登录', async ({ page }) => {
      await page.goto('https://staging.example.com/login');
      await page.fill('input[name="email"]', 'user@example.com');
      await page.fill('input[name="password"]', 'password');
      await page.click('button[type="submit"]');
      // 断言页面跳转到仪表盘
      await expect(page).toHaveURL(/.*dashboard/);
      await expect(page.locator('h1')).toContainText('欢迎回来');
  });

性能测试

• k6 (轻量级，JavaScript 编写脚本)：

  import http from 'k6/http';
  import { check } from 'k6';
  export const options = {
      vus: 10,          // 10 个虚拟用户
      duration: '30s',  // 持续 30 秒
      thresholds: {
          http_req_duration: ['p(95)<200'],  // 95% 请求响应时间 < 200ms
          http_req_failed: ['rate<0.01'],    // 错误率 < 1%
      },
  };
  export default function () {
      let res = http.get('https://example.com/health');
      check(res, { 'status is 200': (r) => r.status === 200 });
  }

CI/CD 集成（以 GitHub Actions 为例）

创建一个 .github/workflows/ci.yml 文件,将上述工具串联起来：

name: PHP CI Pipeline
on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]
jobs:
  quality:
    runs-on: ubuntu-latest
    services:
      # 启动 MySQL/PostgreSQL 用于集成测试
      mysql:
        image: mysql:8.0
        env:
          MYSQL_DATABASE: testing
          MYSQL_ROOT_PASSWORD: root
        ports:
          - 3306:3306
        options: >-
          --health-cmd="mysqladmin ping"
          --health-interval=10s
          --health-timeout=5s
          --health-retries=3
    steps:
      - uses: actions/checkout@v4
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.2'
          extensions: mbstring, pdo_mysql, bcmath
          tools: composer, phpstan, php-cs-fixer
      - name: Install dependencies
        run: composer install --no-interaction --prefer-dist --optimize-autoloader
      # 1. 静态分析
      - name: Run PHPStan
        run: vendor/bin/phpstan analyse --memory-limit=256M --no-progress
      - name: Check coding style
        run: vendor/bin/php-cs-fixer fix --dry-run --diff
      # 2. 单元测试 + 集成测试 (需要数据库)
      - name: Run PHPUnit tests
        env:
          DB_CONNECTION: mysql
          DB_HOST: 127.0.0.1
          DB_PORT: 3306
          DB_DATABASE: testing
          DB_USERNAME: root
          DB_PASSWORD: root
        run: vendor/bin/phpunit --log-junit test-report.xml --coverage-text
      # 3. 构建并部署到测试环境（如果上述测试通过）
      - name: Deploy to Staging
        if: github.ref == 'refs/heads/develop' && success()
        run: |
          # 调用部署脚本，例如使用 Deployer 或 rsync
          echo "Deploying to staging..."
      # 4. 运行 E2E 测试（在 Staging 上）
      - name: Run E2E tests
        if: github.ref == 'refs/heads/develop' && success()
        run: |
          npx playwright test --config=tests/e2e/playwright.config.js
      # 5. 性能测试（预发布阶段手动触发）
      # - name: Load Test (Manual trigger)
      #   if: github.event_name == 'workflow_dispatch'
      #   run: k6 run tests/performance/health.js

关键里程碑与最佳实践

1. 从“单元测试”开始：不需要一开始就追求 E2E 全覆盖，先保证核心逻辑（支付、订单、用户认证）有单元测试覆盖。
2. 测试覆盖率目标：
   • 上线初期：核心功能 60%+ 覆盖。
   • 稳定期：逻辑层 80%+ 覆盖。
   • 注意：覆盖率数字是参考，更要关注测试质量（是否测试了异常路径、边界值）。
3. 数据隔离：
   • 单元测试：使用 Mock,完全不碰数据库。
   • 集成测试：使用 Testcontainer 创建临时数据库,测试完自动销毁。
   • 禁止在测试中使用线上或生产数据库。
4. 测试夹具（Fixtures）管理：
   • 使用 Factory 模式（如 Laravel Factory 或 fakerphp/faker）生成测试数据,避免硬编码。
   • 不要在测试之间共享数据，每个测试独立设置和清理（setUp / tearDown）。
5. 失败即阻断：
   • CI 配置为：任意测试失败 → 阻止合并 PR 或阻止部署。
   • 设置测试超时时间（PHPUnit 设置 timeoutForSmallTests="5"），避免死循环挂起整个 CI。
6. 可视化报告：
   • 使用 phpunit --testdox 生成人类可读的测试描述。
   • 将 clover.xml或junit.xml 上传到 SonarQube 或 Codecov,让团队能看到覆盖率趋势。

针对不同框架的快速启动命令

常见问题与解决方案

上线前必须通过的最低质量门禁

1. ✅ PHPStan Level 9 无错误（最大发现率，最小误报）。
2. ✅ 单元测试全部通过（至少覆盖核心服务层和模型逻辑）。
3. ✅ 关键集成测试通过（数据库增删改查、外部 API 调用（Mock））。
4. ✅ 代码规范通过（php-cs-fixer 或 phpcs）。
5. ✅ （可选但强烈推荐） 安全扫描：运行 composer audit 检查依赖漏洞。

自动化测试不是一蹴而就的，但一旦建立起来，它会成为项目最大的“刹车”——帮你把问题拦截在上线之前,而不是等到用户报告。