phpEnv是一款面向Windows的PHP集成开发环境，它内置了多个PHP版本、Nginx、Apache、MySQL以及composer等工具，适合快速搭建本地开发环境。对于希望引入自动化测试的PHP开发者来说，在phpEnv中安装PHPUnit并不复杂，但需要注意PHP版本与PHPUnit版本的匹配关系。下面直接说明在phpEnv里从零开始配置PHPUnit并运行测试用例的具体做法。
一、确认phpEnv与PHP版本
打开phpEnv控制面板，在主界面可以看到已安装的PHP版本列表。PHPUnit不同大版本对PHP版本有明确要求，例如PHPUnit 9需要PHP 7.3以上，PHPUnit 10需要PHP 8.1以上。因此在安装前，先通过phpEnv将命令行使用的PHP版本切换到目标版本，避免后续出现语法或函数不兼容问题。
phpEnv提供了一个内置的终端按钮，点击后打开的命令行已经自动配置了当前选中PHP版本的环境变量。此时输入以下命令可以确认版本：
php -v composer -V
如果输出的PHP版本符合项目需求，就可以继续安装PHPUnit。不建议在系统全局随意覆盖PHP，因为phpEnv的优势正是多版本共存，用其自带终端即可隔离环境。
二、使用Composer安装PHPUnit
推荐在具体的项目目录中安装PHPUnit，作为开发依赖，这样能锁定版本并方便团队协作者使用相同配置。进入你的项目根目录，在phpEnv终端中执行：
composer require --dev phpunit/phpunit ^9.0
上述命令会让composer从仓库拉取PHPUnit 9系列最新版，并写入composer.json的require-dev节点。安装完成后，vendor/bin目录下会出现phpunit可执行文件。若你希望全局安装，也可执行composer global require phpunit/phpunit，但要注意全局与项目版本的冲突。
安装后可用如下命令验证是否成功：
./vendor/bin/phpunit --version
在Windows的phpEnv终端里，也可以写成vendorbinphpunit --version。看到版本号即代表PHPUnit可执行文件就位，接下来就能编写测试用例。
三、编写第一个测试用例
PHPUnit遵循约定优于配置的原则，默认会递归查找tests目录中以Test.php结尾或继承TestCase的类。我们在项目下新建tests目录，并创建一个示例测试文件。
<?php
use PHPUnitFrameworkTestCase;
class SampleTest extends TestCase
{
public function testAddition()
{
$result = 1 + 1;
$this->assertEquals(2, $result);
}
public function testString()
{
$name = 'phpEnv';
$this->assertStringContainsString('Env', $name);
}
}
上面的代码定义了一个继承TestCase的类，其中两个方法分别以test开头，PHPUnit会自动识别为测试方法。assertEquals用于判断期望值与实际值是否相等，assertStringContainsString则检查字符串包含关系。
把该文件保存为tests/SampleTest.php后，就可以在phpEnv终端运行。建议同时创建phpunit.xml配置文件，指定测试目录与输出格式，减少每次敲命令的参数。
<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php" colors="true">
<testsuites>
<testsuite name="default">
<directory>tests</directory>
</testsuite>
</testsuites>
</phpunit>
四、运行自动化测试
在phpEnv终端进入项目根目录，执行下面指令即可跑起全部用例：
vendor/bin/phpunit
如果配置了phpunit.xml，PHPUnit会自动读取并扫描tests目录。终端将显示每个测试方法的通过或失败状态，失败时给出差异对比，方便定位逻辑错误。配合phpEnv的文件监听或编辑器插件，保存即测试，可大幅提升回归效率。
需要注意，PHPUnit应仅作为开发依赖，不要把它打入生产环境的composer安装；另外当phpEnv切换PHP版本后，若项目依赖的PHPUnit版本不兼容，应重新用对应PHP运行composer update。这样才能保证自动化测试环境长期稳定。
五、常见误区与建议
一个典型误区是在系统PATH里单独下载phpunit.phar并混用不同PHP，结果出现openssl或dom扩展缺失。phpEnv已集成必要扩展，用其终端调用vendor/bin里的PHPUnit最稳妥。另一个误区是忽略phpunit.xml中的bootstrap，导致测试类未自动加载而报类不存在。
从架构角度看，本地用phpEnv跑单元测试只是自动化测试的第一环，后续可把相同composer配置迁移到CI流水线，实现提交即测。保持本地与持续集成环境PHP版本一致，是避免“本地通过线上报错”的关键。
| 操作项 | 推荐做法 | 风险做法 |
|---|---|---|
| 安装PHPUnit | composer require --dev 项目内安装 | 全局混装多版本不锁定 |
| PHP版本 | phpEnv终端切换并确认 | 系统随意覆盖PATH |
| 配置 | 提交phpunit.xml到仓库 | 仅本地手敲参数 |
通过上述步骤，利用phpEnv自带的PHP与composer能力，无需繁琐的系统配置就能完成PHPUnit安装与自动化测试环境搭建，让PHP项目的质量保障更轻松。