Debian如何使用phpstorm进行单元测试

在 Debian 上使用 PhpStorm 进行 PHPUnit 单元测试

一 环境准备

先别急着写测试，得把基础环境搭好。说白了就是两件事：装 PHP 和它的调试扩展 Xdebug。命令很简单：

sudo apt update && sudo apt install -y php php-xdebug

然后装上 Composer——它是 PHP 世界的包管理器，强烈推荐用。同样一条命令搞定：

sudo apt install -y composer

项目用 Composer 管理依赖是常规操作，后续通过 vendor/autoload.php 就能自动加载 PHPUnit 和你的业务代码，省心省力。

二 安装与配置 PHPUnit

PHPUnit 的安装方式有好几种，选你最顺手的就行。

方式 A（推荐，项目内安装）：在项目根目录执行 composer require --dev phpunit/phpunit，这样 PHPUnit 会被安装在项目内部的 vendor 目录下，同时自动生成 vendor/autoload.php。这种方式的好处是不污染全局环境，不同项目可以各自独立管理版本。

方式 B（全局安装）：执行 composer global require phpunit/phpunit，安装后需要把全局 Composer 的 bin 目录加入 PATH 环境变量，才能在命令行里直接敲 phpunit。适合经常在不同项目间切换、想省去反复安装麻烦的情况。

方式 C（PHAR 包）：从 phpunit.de 下载与当前 PHP 版本匹配的 phpunit.phar，放到项目目录或系统路径下，然后在 PhpStorm 里直接指定这个 PHAR 文件即可。简单粗暴，适合不想碰 Composer 的朋友。

三 在 PhpStorm 中配置测试框架

PhpStorm 的配置分为两步：先配好 PHP 解释器，再告诉它 PHPUnit 在哪。

配置 PHP 解释器：打开 Settings（快捷键 Ctrl+Alt+S），进入 Languages & Frameworks → PHP，添加本机的 PHP 可执行文件路径（通常是 /usr/bin/php）。确认版本和扩展都正常显示，尤其是 Xdebug 要亮绿灯。

配置 PHPUnit：在同一个设置页面下找到 Test Frameworks，点击 + 新建一个配置。这里根据你之前选择的安装方式决定：

• 如果用 Composer 项目内安装，选 PHPUnit by Composer，然后指定 vendor/autoload.php 作为引导文件；
• 如果用 PHAR 包，选 PHPUnit by PHAR，然后指定 phpunit.phar 的路径；
• 还可以同时指定项目根目录下的 phpunit.xml 作为配置和引导入口。

配置完成后点击“验证”或“同步”，看到 PHPUnit 的版本号正常加载出来，才算大功告成。

四 编写与运行测试

环境配好了，接下来就是动手写测试。

生成测试文件：在需要测试的目标类上，使用 Na vigate → Go to Test（或快捷键 Ctrl+Shift+T / Cmd+Shift+T），PhpStorm 会帮你自动创建一个测试类骨架，模板选 PHPUnit 即可。当然你也可以手动新建一个文件，继承 PHPUnit\Framework\TestCase。

举个最简单的例子，在 tests/ExampleTest.php 里写上：

assertTrue(true);
    }
}

运行与调试：在测试类或方法上右键，选择 Run ‘类名’/‘方法名’ 即可运行。想调试的话，先在代码行号左侧点击设置断点，然后右键选择 Debug。常用的调试快捷键：F7 进入函数内部、F8 单步跳过、F9 继续执行。熟练之后，调试单元测试就像散步一样轻松。

五 使用 phpunit.xml 与覆盖率

实际项目中很少有人直接命令行敲参数，更多是靠一个 phpunit.xml 配置文件来统一管理。下面是一个典型的模板，放在项目根目录：

    
        
            ./tests
        
    
    
        
            ./src
        
    

这里有几个关键点：

• bootstrap="vendor/autoload.php" 负责自动加载 Composer 依赖以及你的业务代码；
• ./tests 指定了测试文件的位置和命名规则（所有以 Test.php 结尾的文件都会被识别为测试）；
• 配置了代码覆盖率统计的范围，这里只统计 ./src 目录下的源文件，避免把测试代码本身也算进去。

在 PhpStorm 中，你直接右键点击 phpunit.xml 文件，选择运行整个测试套件。如果想查看覆盖率报告，可以在 Run → Edit Configurations → Code Coverage 里勾选启用。跑完之后，IDE 会用绿色和红色高亮标记出每一行代码是否被测试覆盖到，一目了然。

整个流程走下来，你会发现 Debian 上配置 PHPUnit 和 PhpStorm 的组合并没有想象中那么复杂。关键就两步：装好环境、配好 IDE，剩下的就是写测试、跑测试、看覆盖率的日常循环了。