PHP单元测试框架与持续集成环境配置

接下来创建对应的测试文件tests/CalculatorTest.php：

calculator = new Calculator();
    }
    
    public function testAdd()
    {
        $this->assertEquals(5, $this->calculator->add(2, 3));
        $this->assertEquals(-1, $this->calculator->add(2, -3));
    }
    
    public function testSubtract()
    {
        $this->assertEquals(1, $this->calculator->subtract(3, 2));
        $this->assertEquals(5, $this->calculator->subtract(2, -3));
    }
    
    public function testDivide()
    {
        $this->assertEquals(2, $this->calculator->divide(6, 3));
    }
    
    public function testDivideByZero()
    {
        $this->expectException(InvalidArgumentException::class);
        $this->calculator->divide(6, 0);
    }
}

运行测试：

./vendor/bin/phpunit

如果一切正常，你会看到绿色的成功提示。我第一次看到这个绿色时，那种成就感至今难忘！

数据库测试与测试替身

真实项目中经常需要测试数据库操作。我推荐使用PHPUnit的数据库扩展，但要注意避免测试间的相互影响。

conn === null) {
            if (self::$pdo == null) {
                self::$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
            }
            $this->conn = $this->createDefaultDBConnection(self::$pdo, 'test');
        }
        return $this->conn;
    }
    
    public function getDataSet()
    {
        return $this->createXMLDataSet(__DIR__ . '/fixtures/users.xml');
    }
    
    public function testUserCount()
    {
        $this->assertEquals(2, $this->getConnection()->getRowCount('users'));
    }
}

对于复杂的外部依赖，我习惯使用Mock对象。这是我踩过很多坑后总结出的经验：

createMock(PaymentGateway::class);
        $paymentGateway->expects($this->once())
                      ->method('charge')
                      ->with(100, 'USD')
                      ->willReturn(true);
        
        $paymentService = new PaymentService($paymentGateway);
        $result = $paymentService->processPayment(100, 'USD');
        
        $this->assertTrue($result);
    }
}

GitHub Actions持续集成配置

现在进入持续集成环节。我选择GitHub Actions，因为它与GitHub无缝集成且免费额度足够个人项目使用。

在项目根目录创建.github/workflows/php.yml：

name: PHP CI

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    
    services:
      mysql:
        image: mysql:5.7
        env:
          MYSQL_ROOT_PASSWORD: root
          MYSQL_DATABASE: test
        ports:
          - 3306:3306
        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3

    steps:
    - uses: actions/checkout@v2
    
    - name: Setup PHP
      uses: shivammathur/setup-php@v2
      with:
        php-version: '8.0'
        extensions: mbstring, xml, json, mysql, pdo_mysql
        coverage: xdebug
        
    - name: Validate composer.json and composer.lock
      run: composer validate --strict
      
    - name: Cache Composer packages
      id: composer-cache
      uses: actions/cache@v2
      with:
        path: vendor
        key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
        restore-keys: |
          ${{ runner.os }}-php-
          
    - name: Install dependencies
      run: composer install --prefer-dist --no-progress --no-suggest
      
    - name: Prepare test environment
      run: |
        php bin/console doctrine:database:create --if-not-exists
        php bin/console doctrine:schema:update --force
        
    - name: Run test suite
      run: ./vendor/bin/phpunit --coverage-text --coverage-clover=coverage.xml
      
    - name: Upload coverage to Codecov
      uses: codecov/codecov-action@v1
      with:
        file: ./coverage.xml
        flags: unittests
        name: codecov-umbrella

代码质量工具集成

除了单元测试，代码质量检查也很重要。我习惯在CI流水线中加入PHPStan和PHP_CodeSniffer：

# 安装代码质量工具
composer require --dev phpstan/phpstan squizlabs/php_codesniffer

在composer.json中添加脚本：

{
    "scripts": {
        "test": "phpunit",
        "analyse": "phpstan analyse",
        "check-style": "phpcs --standard=PSR12 src tests",
        "fix-style": "phpcbf --standard=PSR12 src tests"
    }
}

更新GitHub Actions配置，添加代码质量检查步骤：

- name: Run static analysis
  run: composer analyse
  
- name: Check coding standards
  run: composer check-style

常见问题与解决方案

在配置过程中，你可能会遇到一些问题。这里分享几个我经常遇到的问题和解决方案：

问题1：测试数据库连接失败
确保测试使用独立的测试数据库，避免影响生产数据。我习惯在phpunit.xml中通过环境变量配置测试数据库：

问题2：Mock对象设置过于复杂
如果Mock设置变得复杂，说明被测试的类可能违反了单一职责原则。考虑重构代码，使其更易于测试。

问题3：测试运行缓慢
使用SQLite内存数据库进行测试，或者使用DatabaseTransaction trait在每次测试后回滚数据变更。

最佳实践总结

经过多年的实践，我总结了以下几点经验：

1. 测试命名要清晰，遵循test[MethodName][Scenario]模式
2. 每个测试只测试一个场景，保持测试简单
3. 使用有意义的断言消息，便于调试
4. 避免测试中的逻辑判断，测试应该是确定性的
5. 定期清理陈旧的测试，保持测试套件的健康

配置完整的单元测试和持续集成环境需要一些前期投入，但从长远来看，这种投入是值得的。它不仅能提高代码质量，还能增强团队信心，让我们在重构时更加从容。希望这篇教程能帮你顺利搭建自己的测试流水线！