Composer怎么测试组件？在开发中集成PHPUnit流程-composer-PHP中文网

必须用 composer require --dev phpunit/phpunit:^9.6（php 7.4）、^10.5（php 8.0–8.1）或 ^11.0（php 8.2+），配对 phpunit.xml（根目录）、autoload-dev 映射及 bootstrap="vendor/autoload.php"，缺一不可。

composer怎么测试组件？在开发中集成phpunit流程

直接用 composer require --dev phpunit/phpunit 装上，但测试跑不起来，90% 是因为 autoload-dev 没生效、phpunit.xml 没被读到、或测试类根本没被自动加载——三者缺一不可。

怎么装 PHPUnit 才不会版本爆炸

PHPUnit 和 PHP 版本强绑定，装错连 TestCase 都找不到：

PHP 7.4 项目 → 必须用 composer require --dev phpunit/phpunit:^9.6
PHP 8.0–8.1（如 Laravel 10）→ 推荐 ^10.5
PHP 8.2+ → 可试 ^11.0，但确认项目没用已移除的 phpunit-skeleton-generator
绝对别用 --latest：它可能拉到 v11，而你本地是 PHP 8.1，直接报 Declaration of PHPUnitFrameworkTestCase::setUp(): void must be compatible

phpunit.xml 为什么总不生效

它不报错，只静默退回到默认行为（比如只扫当前目录下 *Test.php），常见失效点：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

文件名必须是 phpunit.xml 或 phpunit.xml.dist，且放在和 composer.json 同级的根目录；phpunit.xml.php、tests/phpunit.xml 全无效
bootstrap="vendor/autoload.php" 必须写在 <phpunit></phpunit> 标签里，漏掉这句，use TestsUnitExampleTest 就会报 Class not found
<directory>tests</directory> 是相对路径，以配置文件所在目录（即项目根目录）为基准；写成 ./tests 或 ../tests 多数情况失败
PHP 9.3+ 已废弃 <whitelist></whitelist>，改用 <coverage><include><directory>src</directory></include></coverage>，否则覆盖率报告为空

测试类找不到？先查 autoload-dev 和命名空间对齐

即使 phpunit.xml 写对了，只要路径、命名空间、类名三者不一致，就会报 Class 'TestsUnitExampleTest' not found：

文件路径必须是 tests/Unit/ExampleTest.php
文件内必须声明 namespace TestsUnit;（注意结尾分号，且不能多空格）
类名必须是 ExampleTest，且必须继承 PHPUnitFrameworkTestCase（旧写法 PHPUnit_Framework_TestCase 在 PHP 7.4+ 已彻底废弃）
composer.json 中 autoload-dev 必须包含该映射："autoload-dev": { "psr-4": { "Tests\": "tests/" } }
改完后必须运行 composer dump-autoload，否则新增的映射不生效

CI 里 test 报 Class not found，但本地能过

根本原因不是测试代码问题，而是 CI 默认执行 composer install --no-dev，导致两件事同时失效：

autoload-dev 不加载 → 测试基类（如 tests/Support/TestCase.php）找不到
主命名空间 autoload 配错 → 比如类在 src/Calculator.php、命名空间是 MyPackage，但 composer.json 里写的是 "App\": "src/"，CI 就永远加载不到 MyPackageCalculator
验证方法：CI 脚本里加一行 composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Calculator') ? 'ok' : 'fail';"
别把测试辅助类放进 autoload-dev 后又在 src/ 里 use 它——生产环境 autoload 不含 autoload-dev，CI 必炸