Composer如何与Phpunit集成_测试框架整合要点-composer-PHP中文网

直接用composer require --dev phpunit/phpunit安装后跑不起来，90%因配置错误：PHP版本与PHPUnit主版本不匹配（如PHP 8.1需^10.5）、phpunit.xml缺失bootstrap="vendor/autoload.php"、autoload-dev未声明tests路径、测试类未继承PHPUnitFrameworkTestCase。

composer如何与phpunit集成_测试框架整合要点

直接用 composer require --dev phpunit/phpunit 装上，但跑不起来——90% 的问题出在配置没对上，不是 PHPUnit 本身有问题。

为什么 vendor/bin/phpunit 找不到测试类

根本原因不是路径错了，而是自动加载没触发或继承关系断了。

bootstrap="vendor/autoload.php" 必须写在 phpunit.xml 的 <phpunit></phpunit> 标签里，漏掉这句，use AppTestSomeClass 就会报 Class not found
测试类必须显式继承 PHPUnitFrameworkTestCase，旧写法 PHPUnit_Framework_TestCase 在 PHP 7.4+ 已彻底废弃
如果项目用了 PSR-4 自动加载，得确认 tests/ 目录已在 composer.json 的 autoload-dev 中声明，例如："autoload-dev": { "psr-4": { "Tests\": "tests/" } }
别手动 require 或 include 任何文件——vendor/bin/phpunit 启动时已自动加载 vendor/autoload.php，重复加载会触发 Cannot declare class

phpunit.xml 配置错在哪几个地方就白配

它不报错，只静默退回到默认行为（比如只扫当前目录下 *Test.php），所以你改了配置却没生效，大概率是这几个点：

文件名必须是 phpunit.xml 或 phpunit.xml.dist，且放在和 composer.json 同级的根目录；phpunit.xml.php、phpunit-config.xml 都无效
别手写 DTD 声明（如 ..>），PHPUnit 9.6+ 默认忽略 DTD，写了反而可能因网络不可达导致解析失败
<directory></directory> 的值是相对路径，从项目根目录算起；写成 ./tests/ 或 tests/Unit 都可以，但 ../tests 这种跨级路径多数情况不工作
如果测试要读取环境变量（比如数据库连接），记得在 phpunit.xml 里加 <php><env name="DB_CONNECTION" value="sqlite"></env></php>，否则 $_ENV 是空的

版本选错，连 TestCase 都找不到

PHP 版本和 PHPUnit 主版本强绑定，装错直接 Class 'PHPUnitFrameworkTestCase' not found，因为命名空间或语法层面就不兼容。

Workflow Decomposer

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

下载

PHP 8.2+ → 用 phpunit/phpunit:^11.0 或 ^10.5（LTS）
PHP 8.0–8.1 → 用 phpunit/phpunit:^9.6（这是最后一个支持 PHP 8.0 的 LTS 版）
PHP 7.4 → 只能用 ^8.5，再高会因 mixed 类型提示等语法报错
绝对不要用 composer require --dev phpunit/phpunit:latest —— latest 可能指向 v11，而你的 PHP 是 7.4，装完 composer install 就失败

运行命令为什么总是报 Command not found

不是没装，是没走对入口。Composer 不会把 phpunit 加进系统 PATH。

必须用 ./vendor/bin/phpunit（Linux/macOS）或 vendorinphpunit（Windows），不能直接敲 phpunit
如果提示 Command not found，先检查 vendor/bin/ 目录是否存在，再执行一次 composer install（有时 require --dev 后没重装 autoload）
想省事可以加 alias：alias pu='./vendor/bin/phpunit'，然后用 pu；或者在 composer.json 的 scripts 里加 "test": "phpunit"，之后用 composer test
IDE（如 PHPStorm）右键 Run 时，务必检查运行配置是否勾选了 “Use alternative configuration file”，并指向正确的 phpunit.xml，否则它会跳过配置、只跑单个文件