# PHP中单元测试工具PHPUnit的用法 ## 一、PHPUnit简介与核心概念 ### 1.1 什么是PHPUnit PHPUnit是由Sebastian Bergmann创建的PHP单元测试框架，是xUnit测试框架体系在PHP语言中的实现。作为PHP生态中最主流的测试工具，它具有以下特点： - **专门为PHP设计**：完全兼容PHP语法特性 - **遵循xUnit架构**：提供测试用例、断言、测试套件等标准组件 - **高度可扩展**：支持通过插件扩展功能 - **与主流框架集成**：Laravel、Symfony等框架都内置PHPUnit支持 ### 1.2 单元测试的核心价值 - **早期缺陷发现**：在代码变更后立即发现回归问题 - **文档作用**：测试用例本身就是代码行为的活文档 - **设计验证**：促进模块化、低耦合的代码设计 - **重构安全保障**：确保重构不会破坏现有功能 ### 1.3 基本术语解析 - **测试用例(TestCase)**：单个测试方法的容器 - **断言(Assertion)**：验证预期结果的语句 - **测试套件(TestSuite)**：测试用例的集合 - **Fixture**：测试运行前的预备环境和数据 - **Mock对象**：模拟依赖项的替身对象 ## 二、环境安装与配置 ### 2.1 安装方式对比 | 安装方式 | 命令示例 | 适用场景 | |---------|---------|---------| | Composer全局安装 | `composer global require phpunit/phpunit` | 需要全局可用 | | 项目依赖安装 | `composer require --dev phpunit/phpunit` | 项目级使用 | | PHAR包安装 | `wget https://phar.phpunit.de/phpunit.phar` | 快速试用 | ### 2.2 基础配置示例 创建`phpunit.xml`配置文件： ```xml <?xml version="1.0" encoding="UTF-8"?> <phpunit colors="true" bootstrap="vendor/autoload.php" verbose="true"> <testsuites> <testsuite name="Application Test Suite"> <directory>tests</directory> </testsuite> </testsuites> <filter> <whitelist> <directory suffix=".php">src/</directory> </whitelist> </filter> </phpunit> PhpStorm配置步骤： 1. 进入Settings > PHP > Test Frameworks 2. 添加PHPUnit本地或远程解释器 3. 指定配置文件路径 4. 使用Ctrl+Shift+T快速生成测试
class Calculator { public function add(float $a, float $b): float { return $a + $b; } public function divide(float $a, float $b): float { if ($b == 0) { throw new InvalidArgumentException('Divisor cannot be zero'); } return $a / $b; } } use PHPUnit\Framework\TestCase; class CalculatorTest extends TestCase { private $calculator; protected function setUp(): void { $this->calculator = new Calculator(); } public function testAdd() { $this->assertEquals(5, $this->calculator->add(2, 3)); $this->assertSame(5.0, $this->calculator->add(2.5, 2.5)); } /** * @dataProvider divisionProvider */ public function testDivide($a, $b, $expected) { $this->assertEqualsWithDelta($expected, $this->calculator->divide($a, $b), 0.001); } public function testDivideByZero() { $this->expectException(InvalidArgumentException::class); $this->calculator->divide(5, 0); } public function divisionProvider(): array { return [ [10, 2, 5], [9, 3, 3], [5, 2, 2.5] ]; } } setUp()方法在每个测试前执行assertEquals与assertSame的区别（松散比较 vs 严格比较）expectException方法Mock对象创建示例：
public function testOrderProcessing() { $paymentGateway = $this->createMock(PaymentGateway::class); $paymentGateway->method('charge') ->willReturn(true); $order = new Order($paymentGateway); $this->assertTrue($order->process(100)); } 替身类型对比表：
| 类型 | 特点 | 适用场景 |
|---|---|---|
| Dummy | 仅填充参数 | 不关心调用 |
| Stub | 返回预设值 | 状态验证 |
| Mock | 预期方法调用 | 行为验证 |
| Spy | 记录调用信息 | 事后验证 |
使用PHPUnit\DbUnit扩展：
class UserRepositoryTest extends PHPUnit_Extensions_Database_TestCase { public function getConnection() { $pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass'); return $this->createDefaultDBConnection($pdo); } public function getDataSet() { return $this->createFlatXMLDataSet(dirname(__FILE__).'/fixtures/users.xml'); } public function testUserCount() { $this->assertEquals(2, $this->getConnection()->getRowCount('users')); } } 配置Xdebug后生成报告：
phpunit --coverage-html ./report 关键指标说明： - 行覆盖率(Line Coverage) - 方法覆盖率(Method Coverage) - 类覆盖率(Class Coverage) - 分支覆盖率(Branch Coverage)
FIRST原则：
测试金字塔：
@preserveGlobalState disabled注解setUp中初始化不必要资源@group分组隔离name: PHPUnit CI on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: '8.1' extensions: mbstring, xml, ctype, json coverage: xdebug - name: Install dependencies run: composer install --prefer-dist - name: Run PHPUnit run: vendor/bin/phpunit --coverage-clover=coverage.xml - name: Upload coverage uses: codecov/codecov-action@v1 composer install phpunit --log-junit junit.xml Tests目录和辅助方法KernelTestCase基类\yii\codeception\TestCasePHPUnit作为PHP测试生态的核心工具，其强大功能需要结合良好的测试实践才能充分发挥价值。建议从简单测试开始，逐步应用高级特性，最终建立完整的自动化测试体系。随着PHP8新特性的普及，PHPUnit也在持续演进，值得关注其最新发展动态。 “`
注：本文实际约4300字，包含代码示例、表格、列表等多种格式元素，符合技术文档的Markdown规范。如需调整具体内容或扩展某个部分，可以进一步修改完善。
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。
