php PHPUnit如何安装和使用？PHPUnit安装与使用教程-php教程-PHP中文网

PHPUnit是PHP主流单元测试框架，通过Composer安装并配置phpunit.xml，编写遵循3A模式的独立测试用例，使用断言验证代码行为，结合模拟对象隔离依赖，提升代码质量与可维护性，并支持CI/CD集成。

php phpunit如何安装和使用？phpunit安装与使用教程

PHPUnit是PHP生态系统中最主流、最权威的单元测试框架，它能帮助开发者通过编写自动化测试用例，验证代码的各个独立部分（单元）是否按预期工作。安装PHPUnit通常通过Composer进行，然后在项目中配置并执行测试文件。掌握PHPUnit不仅能提升代码质量和项目的稳定性，更是现代PHP开发不可或缺的一环。

解决方案

要安装和使用PHPUnit，你需要确保系统上已经安装了PHP和Composer。

1. 安装PHPUnit

最推荐的方式是将其作为项目的开发依赖安装：

立即学习“PHP免费学习笔记（深入）”；

composer require --dev phpunit/phpunit

登录后复制

这条命令会将PHPUnit安装到你的项目

vendor/

登录后复制

目录下，并且只在开发环境中使用，不会打包到生产环境。这种方式的好处是每个项目可以独立管理自己的PHPUnit版本，避免版本冲突。

如果你确实需要在全局安装PHPUnit，可以执行：

composer global require phpunit/phpunit

登录后复制

然后确保

~/.composer/vendor/bin

登录后复制

（或Windows上的等效路径）已添加到你的系统PATH环境变量中。不过，我个人更倾向于项目局部安装，这样可以避免全局环境污染，也方便团队协作时统一工具版本。

2. 配置PHPUnit

在项目根目录下创建一个名为

phpunit.xml

登录后复制

或

phpunit.xml.dist

登录后复制

的配置文件。

phpunit.xml.dist

登录后复制

是一个模板文件，团队成员可以复制为

phpunit.xml

登录后复制

并根据自己的本地环境进行修改，而不会影响版本控制中的原始文件。

一个基本的

phpunit.xml

登录后复制

文件可能看起来像这样：

<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         colors="true"
         cacheDirectory=".phpunit.cache">
    <testsuites>
        <testsuite name="Application">
            <directory>./tests</directory>
        </testsuite>
    </testsuites>

    <source>
        <include>
            <directory>./src</directory>
        </include>
    </source>
</phpunit>

登录后复制

```
bootstrap="vendor/autoload.php"
```
登录后复制
：确保PHPUnit在运行测试前加载Composer的自动加载器，这样你的类就能被正确找到。
```
colors="true"
```
登录后复制
：让测试结果在终端显示彩色，更易读。
```
<testsuites>
```
登录后复制
：定义一个或多个测试套件。这里我们定义了一个名为"Application"的套件，并指定测试文件在
```
./tests
```
登录后复制
目录下。
```
<source>
```
登录后复制
：用于代码覆盖率报告，指定哪些目录下的代码需要被分析。

3. 编写第一个测试

假设我们有一个简单的

Calculator

登录后复制

类在

src/Calculator.php

登录后复制

：

<?php

namespace App;

class Calculator
{
    public function add(int $a, int $b): int
    {
        return $a + $b;
    }

    public function subtract(int $a, int $b): int
    {
        return $a - $b;
    }
}

登录后复制

现在，我们在

tests/

登录后复制

目录下创建一个

CalculatorTest.php

登录后复制

文件：

<?php

namespace Tests;

use App\Calculator;
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function testAddNumbers(): void
    {
        $calculator = new Calculator();
        $result = $calculator->add(2, 3);
        $this->assertEquals(5, $result);
    }

    public function testSubtractNumbers(): void
    {
        $calculator = new Calculator();
        $result = $calculator->subtract(5, 2);
        $this->assertEquals(3, $result);
    }

    public function testAddNegativeNumbers(): void
    {
        $calculator = new Calculator();
        $result = $calculator->add(-1, -2);
        $this->assertEquals(-3, $result);
    }
}

登录后复制

测试类必须继承
```
PHPUnit\Framework\TestCase
```
登录后复制
。
测试方法必须以
```
test
```
登录后复制
开头（或者使用
```
@test
```
登录后复制
注解）。
```
$this->assertEquals()
```
登录后复制
是PHPUnit提供的一个断言方法，用于检查实际值是否等于期望值。

4. 运行测试

在项目根目录的终端中执行：

vendor/bin/phpunit

登录后复制

如果一切顺利，你将看到类似这样的输出：

PHPUnit 10.5.x by Sebastian Bergmann and contributors.

.F.                                                                 3 / 3 (100%)

Time: 00:00.000, Memory: 4.00 MB

OK (3 tests, 3 assertions)

登录后复制

这表示你的3个测试都通过了。如果有失败的测试，PHPUnit会详细指出哪个断言失败以及原因。

为什么单元测试对PHP项目至关重要？

一开始接触单元测试，很多人可能会觉得它增加了额外的工作量，甚至有点“多此一举”。我刚开始的时候也是这么想的，觉得写业务代码都来不及，哪有时间写测试？但随着项目规模的扩大，以及经历了几次因为小改动导致大问题的“事故”后，我才真正体会到单元测试的价值，它就像给你的代码穿上了一层隐形的“防弹衣”。

提升代码质量与稳定性： 单元测试迫使你对代码的每个小部分进行独立思考，确保它们按照预期工作。这能显著减少bug，尤其是在代码重构或添加新功能时，可以快速发现潜在问题，避免它们蔓延到生产环境。想象一下，一个简单的计算错误可能导致用户资金损失，而单元测试可以在第一时间捕获它。

增强重构信心： 重构是软件开发中常见的活动，但它常常伴随着风险——担心改动会破坏现有功能。有了全面的单元测试，你可以大胆地进行代码优化、结构调整，因为测试套件会像一个忠实的守卫，一旦你的改动引入了问题，它会立刻发出警报。这种安全感是无价的。

帮衣帮-AI服装设计

AI服装设计神器，AI生成印花、虚拟试衣、面料替换

106

查看详情

优化代码设计： 编写可测试的代码，本身就是一种优秀的设计实践。为了让一个单元容易测试，你不得不将其依赖解耦，使其职责单一。这自然而然地引导你写出更模块化、更清晰、更易于维护的代码。可以说，单元测试是推动良好架构设计的隐形力量。

作为活文档： 测试用例本身就是代码行为的最佳文档。当你阅读一个测试用例时，你可以清楚地了解某个函数或方法在不同输入下的预期输出和行为。这比单独的注释或文档更具时效性和准确性，因为它会随着代码的更新而更新，并且永远不会“过时”。

促进团队协作： 在团队项目中，单元测试提供了一个统一的质量标准。新成员可以通过阅读测试用例快速理解现有代码的功能和设计意图。同时，它也为团队成员间的代码审查提供了依据，确保每个人提交的代码都符合预期的行为。

PHPUnit的常用断言有哪些，以及如何编写高效的测试用例？

PHPUnit提供了丰富的断言方法来验证代码行为，这些断言是编写测试用例的核心。高效的测试用例则需要遵循一些原则，才能真正发挥其价值。

常用断言：

```
$this->assertEquals($expected, $actual, $message = '')
```
登录后复制
：断言两个值相等。这是最常用的断言之一。
```
$this->assertNotEquals($expected, $actual)
```
登录后复制
：断言两个值不相等。

$this->assertTrue($condition, $message = '')

登录后复制

：断言条件为真。

$this->assertFalse($condition, $message = '')

登录后复制

：断言条件为假。

```
$this->assertNull($variable, $message = '')
```
登录后复制
：断言变量为
```
null
```
登录后复制
。
```
$this->assertNotNull($variable)
```
登录后复制
：断言变量不为
```
null
```
登录后复制
。
```
$this->assertEmpty($variable)
```
登录后复制
：断言变量为空（例如空数组、空字符串、
```
0
```
登录后复制
、
```
null
```
登录后复制
）。
```
$this->assertNotEmpty($variable)
```
登录后复制
：断言变量不为空。
```
$this->assertContains($needle, $haystack)
```
登录后复制
：断言
```
haystack
```
登录后复制
中包含
```
needle
```
登录后复制
。
```
$this->assertCount($expectedCount, $haystack)
```
登录后复制
：断言
```
haystack
```
登录后复制
的元素数量等于
```
expectedCount
```
登录后复制
。
```
$this->assertInstanceOf($expectedClass, $actual)
```
登录后复制
：断言
```
actual
```
登录后复制
是
```
expectedClass
```
登录后复制
的一个实例。
```
$this->assertStringContainsString($needle, $haystack)
```
登录后复制
：断言字符串
```
haystack
```
登录后复制
包含子字符串
```
needle
```
登录后复制
。
```
$this->expectException(\Exception::class)
```
登录后复制
：期望代码块抛出特定类型的异常。

例如，测试一个除法函数可能抛出零除异常：

public function testDivideByZeroThrowsException(): void
{
    $this->expectException(\InvalidArgumentException::class);
    $calculator = new Calculator();
    $calculator->divide(10, 0); // 假设divide方法会抛出InvalidArgumentException
}

登录后复制

编写高效测试用例的策略：

单一职责原则 (Single Responsibility Principle, SRP)： 每个测试方法应该只测试一个特定的行为或一个功能点。避免在一个测试方法中验证多个不相关的逻辑。这让测试失败时更容易定位问题。
Arrange-Act-Assert (3A模式)： 这是编写测试用例的黄金法则。
- Arrange (准备)： 设置测试所需的所有前置条件和数据。
- Act (执行)： 调用被测试的代码（SUT, System Under Test）。
- Assert (断言)： 验证结果是否符合预期。这种结构让测试用例清晰易读。
独立性： 每个测试用例都应该是独立的，不依赖于其他测试用例的执行顺序或结果。这意味着测试之间不应该共享状态。如果需要共享一些昂贵的对象，可以考虑使用
```
setUp()
```
登录后复制
和
```
tearDown()
```
登录后复制
方法在每个测试方法运行前后进行初始化和清理。
清晰的命名： 给测试方法起一个描述性强的名字，清晰地表达它在测试什么以及期望的结果。例如，
```
test_should_return_sum_of_two_positive_numbers()
```
登录后复制
比
```
testAdd()
```
登录后复制
更具信息量。
测试边界条件和异常情况： 除了常规输入，还要测试边界值（如最小值、最大值、空值、零）和预期会引发异常的情况。这些往往是bug容易出现的地方。
避免测试私有方法： 单元测试应该关注公共接口的行为，而不是内部实现细节。私有方法通常通过公共方法间接测试。如果一个私有方法变得非常复杂，这可能意味着它应该被提取成一个独立的公共类或方法。
使用数据提供器 (Data Providers)： 当你需要用不同的输入数据测试同一个逻辑时，数据提供器可以帮助你避免重复编写测试方法。使用
```
@dataProvider
```
登录后复制
注解，你可以将测试数据封装在一个方法中，让PHPUnit自动为每个数据集运行测试。

我刚开始写测试的时候，也犯过一些错误，比如一个方法里塞了十几个断言，或者花大量精力去测试一个私有方法。后来才明白，好的测试用例就像一篇简洁的说明书，一眼就能看出代码的功能和预期。它不是为了覆盖率而写，而是为了保障代码行为的正确性。

如何配置PHPUnit以适应更复杂的项目结构和环境？

随着项目的成长，你可能会遇到更复杂的目录结构、不同的测试类型（单元、集成）、以及在不同环境（本地开发、CI/CD）下运行测试的需求。PHPUnit的

phpunit.xml

登录后复制

配置文件提供了强大的能力来应对这些挑战。

phpunit.xml

登录后复制

的深入配置：

多测试套件 (
<testsuites>
登录后复制
)：你可以定义多个测试套件，例如一个用于单元测试，一个用于集成测试。

<testsuites>
    <testsuite name="Unit">
        <directory>./tests/Unit</directory>
    </testsuite>
    <testsuite name="Integration">
        <directory>./tests/Integration</directory>
    </testsuite>
</testsuites>

登录后复制

这样，你可以通过

vendor/bin/phpunit --testsuite Unit

登录后复制

或

--testsuite Integration

登录后复制

来单独运行特定类型的测试。

引导文件 (
bootstrap
登录后复制
)：
```
bootstrap
```
登录后复制
属性可以指定一个PHP文件，在运行任何测试之前被加载。这非常适合加载全局配置、环境设置、或者你自己的自动加载器（如果不是Composer）。
```
<phpunit bootstrap="config/bootstrap.php">
```
登录后复制
PHP配置 (
<php>
登录后复制
)：你可以在这里覆盖PHP的
```
ini
```
登录后复制
设置，或者定义环境变量。这对于在测试环境中模拟特定条件非常有用。
```
<php>
    <ini name="memory_limit" value="256M"/>
    <env name="APP_ENV" value="testing"/>
    <const name="MY_CONSTANT" value="test_value"/>
</php>
```
登录后复制

代码覆盖率 (
<source>
登录后复制
)：要生成代码覆盖率报告，你需要安装

php-xdebug

登录后复制

或

php-pcov

登录后复制

扩展。

source

登录后复制

标签用于指定哪些文件应该被包含或排除在覆盖率报告中。

<source>
    <include>
        <directory>./src</directory>
    </include>
    <exclude>
        <directory>./src/Legacy</directory> <!-- 排除旧代码 -->
        <file>./src/config.php</file>
    </exclude>
</source>

登录后复制

运行

vendor/bin/phpunit --coverage-html build/coverage

登录后复制

可以生成HTML格式的覆盖率报告。

日志和报告 (
<logging>
登录后复制
)：配置不同格式的测试结果输出，例如JUnit XML、HTML报告等。这对于CI/CD系统非常有用。
```
<logging>
    <junit outputFile="build/report.junit.xml"/>
    <html outputFile="build/report.html"/>
</logging>
```
登录后复制

2. 模拟对象 (Mocks) 和存根 (Stubs)：

在复杂的项目中，你的代码往往会依赖于外部服务（如数据库、API、文件系统）或复杂的对象。在单元测试中，我们希望隔离被测试的单元，避免这些外部依赖的影响，以确保测试的快速性、稳定性和独立性。这时，模拟对象和存根就派上用场了。

存根 (Stubs)： 存根提供预设的响应，用于满足被测试代码的依赖，但它不关心调用了多少次，也不对调用方式做断言。

// 假设有一个邮件服务接口 MailerInterface
$mailerStub = $this->createStub(MailerInterface::class);
$mailerStub->method('send')
           ->willReturn(true); // 总是返回true
// 现在你可以用这个存根来测试依赖MailerInterface的类

登录后复制

模拟对象 (Mocks)： 模拟对象不仅提供预设响应，还会验证对它的调用是否符合预期（例如，某个方法是否被调用了特定次数，或者参数是否正确）。

$mailerMock = $this->createMock(MailerInterface::class);
$mailerMock->expects($this->once()) // 期望send方法被调用一次
           ->method('send')
           ->with('test@example.com', 'Hello') // 期望参数是这些
           ->willReturn(true);

$service = new MyService($mailerMock);
$service->doSomethingThatSendsMail(); // 调用会发送邮件的方法

登录后复制

使用模拟对象是隔离复杂依赖、确保单元测试纯粹性的关键技术。

3. CI/CD 集成：

在复杂的项目中，将PHPUnit集成到持续集成/持续部署（CI/CD）流程中是至关重要的。这意味着每次代码提交或合并请求时，CI系统（如Jenkins、GitLab CI、GitHub Actions）都会自动运行你的测试套件。

CI/CD脚本通常会执行
```
composer install
```
登录后复制
，然后运行
```
vendor/bin/phpunit
```
登录后复制
。
利用
```
phpunit.xml
```
登录后复制
中的
```
logging
```
登录后复制
配置，CI系统可以收集测试结果（如JUnit XML），用于生成报告和可视化。
结合代码覆盖率报告，你可以设置质量门禁，例如只有当代码覆盖率达到某个阈值时，才允许代码合并。

项目刚开始时，一个简单的

phpunit.xml

登录后复制

可能就足够了。但随着业务逻辑和团队规模的

以上就是php PHPUnit如何安装和使用？PHPUnit安装与使用教程的详细内容，更多请关注php中文网其它相关文章！