Ubuntu PHPStorm如何进行单元测试

先从安装PHPUnit说起。在Ubuntu终端里，通过Composer全局安装是推荐的做法——这么做最大的好处是灵活，项目之间不会互相打架。

composer global require phpunit/phpunit

装好之后，别忘了把Composer全局bin目录加到系统PATH里，不然终端可能找不到phpunit命令。如果是bash用户，编辑~/.bashrc或~/.zshrc文件，加上这么一行：

export PATH="$PATH:$HOME/.composer/vendor/bin"

然后运行source ~/.bashrc或source ~/.zshrc让配置生效。当然，也可以直接从Ubuntu软件仓库安装（sudo apt-get install phpunit），但全局安装确实更灵活一些。

接下来配置PhpStorm。打开PhpStorm，找到 File > Settings（macOS上则是 PhpStorm > Preferences），然后一路找到 Tools > PHP > PHPUnit。这里要做两件事：

• 告诉PhpStorm phpunit可执行文件在哪。如果刚才全局安装成功了，PhpStorm通常会自动检测到路径，比如 /usr/bin/phpunit 或 ~/.composer/vendor/bin/phpunit。万一没检测到，手动填上就行。
• 勾选 Use configuration file，并指定项目根目录下的 phpunit.xml 配置路径（这个文件后面会创建）。确认后保存。

然后就是创建测试目录和测试用例。在项目根目录下建立一个 tests 目录，按照PHPUnit的惯例，所有测试文件都放这里面。新建一个测试类文件，比如 ExampleTest.php，内容要继承 PHPUnit\Framework\TestCase，测试方法以 test 开头：

assertTrue(true);   // 验证true等于true
    }

    public function testAddition()
    {
        $this->assertEquals(4, 2 + 2); // 验证2+2等于4
    }
}

测试类命名有个约定：类名Test.php，比如 UserModelTest.php 对应 UserModel 类。

话说回来，光有测试还不够，得让PhpStorm知道跑哪些测试、怎么跑。所以需要在项目根目录下放一个 phpunit.xml 配置文件，定义测试套件和白名单等：

    
        
            ./tests
        
    
    
        
            ./src
        
    

• bootstrap：指定自动加载文件，通常是Composer生成的 vendor/autoload.php，保证测试时能加载项目中的类。
• testsuites：定义测试套件，告诉PHPUnit去哪找测试文件、文件名是什么模式（比如 Test.php 结尾）。
• filter：设置代码白名单，比如 src 目录下的 .php 文件，用于生成测试覆盖率报告。

现在可以跑测试了。PhpStorm提供了几种方式，都很直观：

• 跑单个测试方法：在编辑器中打开测试方法，右键点击方法名，选择 Run 'testMethodName()'。
• 跑整个测试类：在编辑器或项目视图中右键点击测试类文件，选 Run 'ClassName'。
• 跑所有测试：右键点击 tests 目录，选择 Run 'All Tests'；或者从顶部工具栏的绿色三角形下拉列表中选择PHPUnit配置。

测试结果会显示在 Run 工具窗口里，通过/失败、执行时间、错误详情一览无余。

如果测试挂了，或者需要排查更深的问题，PhpStorm的调试功能可以帮上大忙。在测试方法里需要检查的地方设置断点（点击行号左侧出现红色圆点），然后右键选 Debug 'testMethodName()'。PhpStorm会进入调试模式，变量值、调用栈都能一步步看，定位问题非常方便。

最后提醒几点：

• 确保PhpStorm中配置的PHP解释器版本和项目一致（到 File > Settings > PHP 检查一下）。
• 如果项目用Composer管理依赖，vendor/autoload.php 文件必须存在（运行 composer install 生成）。
• 测试覆盖率也可以在 phpunit.xml 中配置输出，然后从 Run 工具窗口查看报告。