CakePHP4.x 如何在shell中运行PHPUnit单元测试脚本？

CakePHP 4.x 适配PHPUnit 9.5版本，你的依赖配置无需修改，按以下步骤操作即可正常运行测试：

1. 优先使用框架封装的测试命令 #

CakePHP 4.x 自带适配框架逻辑的测试CLI工具，会自动处理自动加载、环境初始化等操作，兼容性比直接调用原生PHPUnit命令更好：

• 运行全部测试：bin/cake test（Windows环境使用bin\cake test）
• 运行指定层级的所有测试（例如控制器层测试）：bin/cake test Controller
• 运行单个测试文件：bin/cake test Controller/UsersControllerTest
• 运行单个测试方法：bin/cake test Controller/UsersControllerTest testView

2. 直接调用PHPUnit命令的正确写法 #

如果需要直接使用vendor/bin/phpunit命令，需要确保配置文件加载正常，推荐显式指定配置文件路径：

• 根目录下运行所有测试：vendor/bin/phpunit -c phpunit.xml.dist
• 运行指定测试类：vendor/bin/phpunit -c phpunit.xml.dist tests/TestCase/Controller/UsersControllerTest.php

注意：CakePHP的测试类统一存放在项目根目录的tests/TestCase/路径下，命名需要符合[业务层名称]/[类名]Test.php的规范，且类必须继承Cake\TestSuite\TestCase，测试方法名必须以test开头才会被识别

3. 无预期输出的常见排查点 #

• 确认根目录存在phpunit.xml.dist配置文件和tests/bootstrap.php测试引导文件，这两个是CakePHP默认生成的项目必备文件，缺失可以从同版本的CakePHP应用骨架中获取对应内容
• 执行composer dump-autoload重建自动加载映射，避免新增测试类未被加载
• 在命令后加-v参数输出详细调试日志，排查具体报错原因，例如bin/cake test -v
• 确认当前PHP版本 >=7.3，符合PHPUnit 9.5和CakePHP 4.x的版本要求

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