1. 安装PHPUnit
在Ubuntu上,PHPUnit可以通过两种方式安装:
sudo apt-get update && sudo apt-get install phpunit/phpunit,安装后可通过phpunit --version验证。composer require --dev phpunit/phpunit,安装后PHPUnit的可执行文件位于vendor/bin/phpunit。2. 配置PHPStorm
打开PHPStorm,依次进入File > Settings > Languages & Frameworks > PHP > Test Frameworks:
+添加框架,选择PHPUnit by Remote Interpreter(若使用Composer安装)或PHPUnit Local(若使用系统安装)。/usr/bin/phpunit(可通过which phpunit确认);vendor/bin/phpunit。Path to script,填写vendor/autoload.php(Composer项目的自动加载文件),确保测试时能正确加载依赖。3. 创建测试类
在项目中新建tests目录(常规做法,用于存放测试文件),创建以Test结尾的PHP文件(如ExampleTest.php),内容如下:
<?php
use PHPUnit\Framework\TestCase;
class ExampleTest extends TestCase {
public function testAddition() {
$this->assertEquals(4, 2 + 2); // 断言:验证2+2等于4
}
public function testStringContains() {
$this->assertStringContainsString('foo', 'foobar'); // 断言:验证字符串包含子串
}
}
?>
测试类需继承TestCase,方法名以test开头(PHPUnit会自动识别)。
4. 运行测试
Run 'ExampleTest'(运行整个类)或Run 'testAddition()'(运行单个方法)。Terminal窗口,输入vendor/bin/phpunit(Composer安装)或phpunit(系统安装),可运行所有测试;若需运行特定测试,添加--filter参数,如vendor/bin/phpunit --filter testAddition。5. 查看测试结果
测试运行后,结果会显示在PHPStorm底部的Run工具窗口中:
6. 可选优化:集成Xdebug(调试测试)
若需调试测试代码(如设置断点、单步执行),需配置Xdebug:
sudo apt-get install php-xdebug(Ubuntu 22.04+)或对应版本的Xdebug包。/etc/php/<version>/cli/php.ini(CLI环境),添加或修改以下内容:zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
File > Settings > PHP > Debug,确保Xdebug已启用,Debug port设置为9003(与php.ini一致);进入Servers,添加项目服务器,开启Use path mappings,设置本地项目路径与远程路径(若为本地开发,远程路径可留空)。Debug 'ExampleTest',PHPStorm会进入调试模式,可通过F7(进入方法)、F8(跳过方法)、F9(继续执行)控制调试流程。