Composer如何配合PHPUnit做测试_Composer测试依赖配置操作说明【详解】
直接运行 composer require --dev phpunit/phpunit 安装，但装完却跑不起来？这种情况十有八九，问题出在几个不起眼的配置环节：要么是 phpunit.xml.dist 文件放错了位置，要么是 autoload-dev 配置缺失或没生效，再不然就是不小心调用了全局的 phpunit 命令。
怎么装 PHPUnit 才不会埋坑
首先得明确一点：安装时千万别漏掉 --dev 参数。如果执行了 composer require phpunit/phpunit，这个测试框架就会被写入 require 区块，导致生产环境部署时也带上它，不仅浪费资源，还可能干扰自动加载器的正常工作。
- 针对 PHP 7.4–8.0 的项目：请运行
composer require --dev phpunit/phpunit:^9.6 - 针对 PHP 8.1+ 的项目：则使用
composer require --dev phpunit/phpunit:^10.5 - 安装后验证：立即执行
./vendor/bin/phpunit --version，应该能正常输出版本号。如果提示Command not foundvendor/bin/目录是否存在，然后重新运行一次composer install。 - 一个常见的误区：绝对不要使用
composer global require phpunit/phpunit。当不同项目依赖不同主版本的 PHPUnit 时，全局命令必然引发冲突，而且在 CI 环境中，默认也找不到这个全局安装的命令。
phpunit.xml.dist 必须放哪、写什么
这个配置文件的位置和内容，是决定测试能否启动的关键。文件必须放在与 composer.json 同级的项目根目录下，名称必须是 phpunit.xml 或 phpunit.xml.dist。哪怕少一个字母或多一个空格，PHPUnit 都会静默地回退到默认扫描逻辑，你的 tests/ 目录很可能就被忽略了。
- 最简可用的配置只需包含三个核心部分：
bootstrap="vendor/autoload.php"（确保类能被自动加载）、tests src - 如果漏掉了
phpunit --coverage-html生成覆盖率报告时，也无法统计src/目录下的代码。 - 一旦
bootstrap路径写错（比如写成autoload.php或vendor/autoload），运行时就会报Class not found—— 这往往不是类真的不存在，而是自动加载机制根本没有被启动。
autoload-dev 配错会导致 CI 全军覆没
一个典型的场景是：本地运行 composer test 一切正常，但一到 CI 环境就报错 Class 'MyPackageCalculator' not found。这八成是因为 composer.json 里的 autoload 和 autoload-dev 配置没有对齐，或者压根就没有声明 autoload-dev。
立即学习“PHP免费学习笔记（深入）”；
- 首要检查点：运行
composer show my/package，查看输出中autoload行是否与你src/目录下类的实际命名空间匹配。例如，如果类文件在src/Http/Client.php，命名空间是MyPackageHttp，那么composer.json中的autoload配置就应该是"MyPackage\": "src/"。 - 必须显式声明：
autoload-dev必须明确指定测试类的路径，例如："Tests\": "tests/"。修改后，务必执行composer dump-autoload，否则新的映射关系不会生效。 - CI 环境预验证：可以在 CI 脚本中加入一行验证命令：
composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Calculator') ? 'ok' : 'fail';"，这有助于提前暴露自动加载配置错位的问题。 - 一个关键禁忌：不要在
src/生产代码中使用类似use Tests\Support\TestCase的语句。因为autoload-dev不参与生产环境的自动加载，当 CI 使用--no-dev参数安装依赖时，这行use语句就会直接导致错误。
为什么 vendor/bin/phpunit 执行时报 Class 'PHPUnit\Framework\TestCase' not found
遇到这个错误，先别急着重新安装 PHPUnit。这通常不是 PHPUnit 没装好，而是它的类没有被自动加载机制引入，或者整个执行流程根本没有经过 Composer 的自动加载。
- 第一步操作：不是重装，而是运行
composer dump-autoload，强制重建所有类的映射关系。 - 排查引导文件：可以在
vendor/autoload.php文件开头临时添加var_dump(__FILE__); exit;，以确认phpunit.xml.dist中配置的bootstrap路径确实正确指向了这个文件。 - 检查 IDE 配置：在使用 IDE（如 PHPStorm）右键运行测试时，请检查运行配置是否勾选了 “Use alternative configuration file”，并正确指向了你的
phpunit.xml.dist。否则，IDE 可能会绕过 bootstrap 配置，直接 require 单个测试文件。 - 注意类名：测试类必须继承
PHPUnit\Framework\TestCase，而不是旧版的PHPUnit_Framework_TestCase（后者已被废弃，在 v9+ 版本中不再兼容）。
说到底，真正让人卡住的，往往不是测试断言怎么写，而是那些底层配置细节：phpunit.xml.dist 里少了个斜杠、composer.json 中命名空间多写了个反斜杠、或者 CI 脚本里忘了执行 composer dump-autoload 这一步。这些地方不盯紧，./vendor/bin/phpunit 命令就总会在同一个底层错误上循环失败。
