phpstorm Ubuntu版如何使用单元测试_运维文库_资讯中心

发布时间:2026-04-26 23:51:12

阅读量:2

1. 准备工作：安装PHP与Composer
在Ubuntu上使用PhpStorm进行单元测试前，需确保系统已安装PHP（建议版本≥7.4）和Composer（PHP依赖管理工具）。可通过以下命令安装：

sudo apt update
sudo apt install php php-cli php-mbstring php-xml composer

安装完成后，通过php -v和composer -V验证安装是否成功。

2. 安装PHPUnit
PHPUnit是PHP主流单元测试框架，推荐通过Composer以项目依赖形式安装（避免全局污染）：

cd /path/to/your/project  # 进入项目根目录
composer require --dev phpunit/phpunit

安装后，PHPUnit的可执行文件会位于项目根目录的vendor/bin/phpunit路径下。

3. 配置PhpStorm的PHPUnit
打开PhpStorm，进入File > Settings > Tools > PHP > PHPUnit（Windows/Linux路径），完成以下设置：

选择PHPUnit可执行文件：点击“…”按钮，浏览至项目根目录下的vendor/bin/phpunit（若全局安装，可选择系统PATH中的路径，如/usr/local/bin/phpunit）；
启用配置文件：勾选“Use configuration file”，指定项目根目录下的phpunit.xml（后续会创建）；
设置PHP CLI解释器：进入File > Settings > Languages & Frameworks > PHP > CLI Interpreter，选择Ubuntu系统的PHP路径（如/usr/bin/php）或WSL中的PHP路径（若使用WSL）。

4. 创建phpunit.xml配置文件
在项目根目录下创建phpunit.xml，定义测试范围、Bootstrap文件及代码覆盖率规则（示例）：

"1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php" colors="true">
    <testsuites>
        <testsuite name="Application Tests">
            
            <directory suffix="Test.php">./testsdirectory>
        testsuite>
    testsuites>
    <filter>
        
        <whitelist processUncoveredFilesFromWhitelist="true">
            <directory suffix=".php">./srcdirectory>
        whitelist>
    filter>
phpunit>

此配置会自动加载vendor/autoload.php（Composer自动加载），并扫描tests目录下所有以Test.php结尾的测试文件，同时覆盖src目录下的PHP源代码。

5. 编写测试用例
在项目根目录下创建tests目录（与phpunit.xml中的配置一致），新建测试类文件（如ExampleTest.php）。测试类需继承PHPUnit\Framework\TestCase，且测试方法以test开头（PHPUnit会自动识别）：


namespace Tests;

use PHPUnit\Framework\TestCase;

class ExampleTest extends TestCase
{
    public function testBasicAssertions()
    {
        // 断言相等
        $this->assertEquals(4, 2 + 2);
        // 断言为真
        $this->assertTrue(true);
        // 断言包含
        $this->assertStringContainsString('foo', 'foobar');
    }

    public function testArrayContains()
    {
        $array = ['apple', 'banana', 'orange'];
        $this->assertContains('banana', $array);
    }
}

测试类文件名需遵循{ClassName}Test.php规范（如UserModelTest.php对应UserModel类）。

6. 运行单元测试
PhpStorm提供多种运行测试的方式：

运行单个测试方法：在测试类编辑器中，右键点击测试方法（如testBasicAssertions），选择Run 'testBasicAssertions'；
运行单个测试类：右键点击测试类文件（如ExampleTest.php），选择Run 'ExampleTest'；
运行全部测试：右键点击tests目录或项目根目录，选择Run 'All Tests'；
终端运行：打开PhpStorm的Terminal窗口，输入vendor/bin/phpunit（或phpunit，若全局安装），即可运行所有测试。

7. 查看与调试测试结果
测试运行后，结果会显示在PhpStorm底部的Run工具窗口中：

通过/失败统计：绿色表示通过，红色表示失败；
失败详情：点击失败测试方法，可查看具体错误信息（如断言不符、异常抛出）；
调试测试：在测试方法中设置断点（点击行号左侧），右键选择Debug 'testBasicAssertions'，即可进入调试模式（支持变量查看、单步执行等功能）。

8. 可选：集成WSL环境（针对Ubuntu WSL用户）
若使用Ubuntu的WSL（Windows Subsystem for Linux）作为开发环境，需配置PhpStorm使用WSL的PHP CLI和PHPUnit：

配置PHP CLI：进入File > Settings > Languages & Frameworks > PHP > CLI Interpreter，点击+→From WSL，选择WSL中的Ubuntu发行版及PHP路径（如/usr/bin/php）；
配置PHPUnit：在PHPUnit设置中，将“PHPUnit executable”指向WSL中的路径（如/mnt/c/Users/YourName/projects/myproject/vendor/bin/phpunit）；
配置Xdebug：在WSL的php.ini中添加Xdebug配置（如xdebug.remote_host=localhost，xdebug.remote_port=9001），并在PhpStorm中开启Xdebug调试功能。

以上就是关于“phpstorm Ubuntu版如何使用单元测试”的相关介绍，筋斗云是国内较早的云主机应用的服务商，拥有10余年行业经验，提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩，主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复；电子化备案，提交快速，专业团队7×24小时服务支持！

简单好用、高性价比云服务器租用链接：https://www.jindouyun.cn/product/cvm