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

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

一 环境准备

• 安装 PHP 与调试扩展：sudo apt update && sudo apt install -y php php-xdebug
• 安装 Composer（推荐）：sudo apt install -y composer
• 建议项目使用 Composer 管理依赖，后续通过 vendor/autoload.php 加载 PHPUnit 与业务代码。

二 安装与配置 PHPUnit

• 方式 A（推荐，项目内安装）：在项目根目录执行 composer require --dev phpunit/phpunit，生成 vendor/autoload.php 与 PHPUnit。
• 方式 B（全局安装）：composer global require phpunit/phpunit，然后将全局 Composer 的 bin 目录加入 PATH，以便命令行使用 phpunit。
• 方式 C（PHAR 包）：从 phpunit.de 下载与当前 PHP 版本匹配的 phpunit.phar，保存到项目或系统路径，并在 PhpStorm 中指定该 PHAR。

三 在 PhpStorm 中配置测试框架

• 配置 PHP 解释器：File > Settings > Languages & Frameworks > PHP，添加本机 php 可执行文件，确认版本与扩展正常。
• 配置 PHPUnit：File > Settings > Languages & Frameworks > PHP > Test Frameworks，点击 + 新建：
  • 选择 PHPUnit by Composer（项目内安装时），指定 vendor/autoload.php 作为引导；
  • 或选择 PHPUnit by PHAR，指定下载的 phpunit.phar；
  • 可同时指定项目根目录的 phpunit.xml 作为配置与引导入口。完成后点击验证/同步，确保识别到 PHPUnit 类与版本。

四 编写与运行测试

• 生成测试：在目标类上使用 Navigate > Go to Test（或 Ctrl+Shift+T / Cmd+Shift+T）创建测试，选择 PHPUnit 模板；也可新建文件并继承 PHPUnit\Framework\TestCase。
• 基本测试示例（tests/ExampleTest.php）：
  • 示例：
    • assertTrue(true); - } - }
• 运行与调试：
  • 在测试类或方法上右键选择 Run ‘ClassName’/‘testMethod’；
  • 需要断点调试时，在代码行号左侧点断点，右键选择 Debug；常用快捷键：F7 进入、F8 步过、F9 继续。

五 使用 phpunit.xml 与覆盖率

• 基本 phpunit.xml（项目根目录）：
  • • ./tests
    • ./src
• 要点：
  • bootstrap=“vendor/autoload.php” 用于自动加载依赖；
  • ./tests 指定测试目录与文件后缀；
  • 配置覆盖率统计范围（统计 src 下代码的覆盖率）；
  • 在 PhpStorm 中可直接对 phpunit.xml 右键运行整个测试套件，并可在设置中启用覆盖率（Run > Edit Configurations > Code Coverage）查看覆盖率报告。