如何在PhpStorm中配置运行容器内的PHPUnit测试

直接按以下步骤配置，就能点击“运行”按钮自动执行测试：

1. 把Docker连接到PhpStorm #

• 打开PhpStorm设置（快捷键Ctrl+Alt+S，或顶部菜单File > Settings）
• 找到Build, Execution, Deployment > Docker
• 点击左上角+，根据你的系统选择对应Docker类型（比如Docker for Mac），点击Apply后测试连接，确保显示“Connection successful”

2. 配置基于Docker Compose的PHP解释器 #

• 仍在设置界面，进入Languages & Frameworks > PHP
• 点击CLI Interpreter右侧的...按钮，打开解释器管理窗口
• 点击+，选择From Docker, Vagrant, VM, WSL...
• 在弹出窗口选Docker Compose，然后：
  • Server选刚才配置好的Docker连接
  • Service选你docker-compose.yml里的app服务
  • 点击OK，等待PhpStorm加载容器内的PHP环境
• 回到PHP设置页面，确认新配置的解释器被选中，保存设置

3. 配置PHPUnit运行项 #

• 点击顶部菜单Run > Edit Configurations
• 点击+，选择PHPUnit
• 在配置页面填写：
  • Name：自定义名称，比如Sample Test
  • Test runner：项目有phpunit.xml就选Defined in the configuration file，没有则选Path to script并指向容器内的vendor/bin/phpunit
  • PHP interpreter：选刚才配置的Docker Compose解释器
  • Test部分：选Specific file，然后选中你的unitTest/Sample.php
• 点击Apply和OK

现在点击运行按钮，PhpStorm会自动完成进入容器、切换目录、执行测试的全套操作，不用再手动敲命令。

注意：确保docker-compose.yml在PhpStorm项目根目录，且容器内app/目录和本地项目目录有正确的volume映射，避免路径识别问题。

内容的提问来源于stack exchange，提问作者SoluriX