PhpStorm中Docker容器内单个PHP测试无法运行的问题

运行全部测试（正常） #

在PhpStorm中运行全部测试时，点击「Run」>>「MyProject PhpUnit Test」，执行的命令如下：

[docker-compose://[/path/to/my/project/docker-compose.yml]:php/]:/usr/local/bin/php /var/www/docroot/bin/phpunit --configuration /var/www/docroot/phpunit.xml.dist --teamcity

该命令可正常执行全部测试。

运行单个测试（失败） #

进入单个测试用例，右键点击测试名称「Run testAppendShortToAnswers...」（快捷键：CTRLShiftR），执行的命令如下：

[docker-compose://[/path/to/my/project/docker-compose.yml]:php/]:/usr/local/bin/php /var/www/docroot/bin/phpunit --configuration /var/www/docroot/phpunit.xml.dist --filter "/(App\\Tests\\Entity\\CardTest::testAppendShortToAnswers)( .*)?$/" --test-suffix CardTest.php /path/to/my/project/tests/Entity --teamcity

执行后立即报错：

Cannot open file "/path/to/my/project/tests/Entity.php".

Process finished with exit code 1

推测问题出在PhpStorm使用了宿主机路径而非Docker容器内的路径来访问测试文件。

环境信息 #

• 运行环境：Mac
• 项目类型：Symfony项目
• PHPUnit位置：项目根目录的/bin/phpunit，未通过Composer安装

已尝试的有效方案（终端运行） #

在终端执行以下命令可正常运行单个测试：

docker-compose exec php /usr/local/bin/php /var/www/docroot/bin/phpunit --filter testAppendShortToAnswers

但需求是直接在PhpStorm中用快捷键运行单个测试。

解决方案 #

1. 检查并配置PhpStorm路径映射 #

PhpStorm需要正确识别宿主机与Docker容器的路径对应关系：

• 打开PhpStorm「Settings」（快捷键：Cmd+,）
• 导航到「Build, Execution, Deployment」>>「Docker」>>「Docker Compose」
• 找到对应服务的「Volume Bindings」，确认宿主机的/path/to/my/project对应容器内的/var/www/docroot
• 若映射缺失或错误，手动添加：宿主机路径填项目根目录，容器路径填/var/www/docroot，按需勾选「Read-only」

2. 调整PHPUnit运行模板配置 #

修改PhpStorm的PHPUnit运行模板，避免生成含宿主机路径的命令：

• 打开「Run」>>「Edit Configurations」
• 找到「PHPUnit」类型，点击「Edit configuration templates」
• 在「Test runner options」中，确保不包含宿主机文件路径参数；同时在「Configuration」标签页，确认未勾选「Use Composer autoloader」，并指定容器内的/var/www/docroot/bin/phpunit作为PHPUnit可执行文件路径

3. 临时修改单个测试的运行配置 #

若上述配置仍无效，可手动调整单个测试的运行命令：

• 运行单个测试后，在「Run」面板点击配置名称旁的编辑按钮
• 将命令中的--test-suffix CardTest.php /path/to/my/project/tests/Entity参数删除，保留核心命令：

  [docker-compose://[/path/to/my/project/docker-compose.yml]:php/]:/usr/local/bin/php /var/www/docroot/bin/phpunit --configuration /var/www/docroot/phpunit.xml.dist --filter "/(App\\Tests\\Entity\\CardTest::testAppendShortToAnswers)( .*)?$/" --teamcity
  

• 保存配置后，后续运行该测试将使用修改后的命令

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