使用 composer 安装 phpUnit 可通过 composer require –dev phpunit/phpunit 命令实现,随后运行 ./vendor/bin/phpunit –generate-configuration 生成配置文件,设置 testsuite 和 bootstrap 等参数,创建 tests 目录并编写测试类,最后执行 ./vendor/bin/phpunit 运行测试,确保 composer.json 中已配置 autoload 并执行 composer dump-autoload 以正确加载类。

使用 Composer 安装和配置 PHPUnit 是 PHP 项目中实现单元测试的标准方式。只要正确设置,就能快速开始编写和运行测试。
安装 PHPUnit 通过 Composer
在项目根目录下执行以下命令,将 PHPUnit 作为开发依赖安装:
composer require –dev phpunit/phpunit
这条命令会自动下载 PHPUnit 及其依赖,并将其添加到 composer.json 的 require-dev 部分。推荐始终以开发依赖方式安装,避免影响生产环境。
生成基本配置文件
PHPUnit 使用 phpunit.xml 或 phpunit.xml.dist 作为配置文件。你可以手动创建,也可以使用内置命令生成基础模板:
立即学习“PHP免费学习笔记(深入)”;
先运行:
./vendor/bin/phpunit –generate-configuration
该命令会提示输入一些基本信息,如测试目录路径、Bootstrap 文件等,并生成一个基础的 phpunit.xml.dist 文件。
常见配置项说明:
- bootstrap:指定测试前自动加载的 PHP 文件,常用于引入自动加载或初始化逻辑
- testsuite:定义测试文件的存放目录,例如
tests/ - coverage(可选):配置代码覆盖率报告的输出路径
编写和运行第一个测试
在项目中创建 tests 目录,并添加一个简单测试示例:
// 文件:tests/ExampleTest.php
<?php
use PHPUnitFrameworkTestCase;
class ExampleTest extends TestCase
{
public function testTrueIsTrue() {
$this->assertTrue(true);
}
}
然后运行测试:
./vendor/bin/phpunit
如果配置正确,你会看到类似“OK (1 test, 1 assertion)”的输出结果。
小贴士与注意事项
确保 autoload 在 composer.json 中已配置好,以便测试类能正确加载被测代码。例如:
“autoload”: {
“psr-4”: { “app”: “src/” }
}
修改后记得运行:
composer dump-autoload
这样测试中才能正常使用命名空间引入项目类。
基本上就这些。Composer 安装 PHPUnit 简单直接,重点是配置好路径和自动加载。之后就可以专注写测试了。


