在 Composer 包中运行 PHPUnit 测试需确保：安装 phpunit/phpunit 为 dev 依赖，配置正确 phpunit.xml（含 testsuites 和 autoload）、composer.json 的 autoload 与 autoload-dev（如 "MyPackage": "src/" 和 "MyPackageTests": "tests/"），运行 composer dump-autoload，并将测试文件置于 tests/ 目录、命名以 Test.php 结尾、类继承 TestCase 且命名空间匹配。

怎么在 Composer 包里跑起 PHPUnit 测试

Composer 本身不负责运行测试，它只是装包的工具；真正跑测试的是 phpunit。你得先确保包项目根目录下有 phpunit.xml 或 phpunit.xml.dist，且已通过 composer require --dev phpunit/phpunit 装好开发依赖。

常见错误现象：vendor/bin/phpunit 找不到命令、Class 'PHPUnitFrameworkTestCase' not found、测试文件没被自动发现。

• 测试文件默认要放在 tests/ 目录，命名以 Test.php 结尾（如 ExampleTest.php）
• phpunit.xml 里必须正确配置 <testsuites> 和 <autoload>（尤其是 psr-4 映射，否则类加载失败）
• 如果用 PHP 8+，别装太老的 PHPUnit 版本——phpunit/phpunit:^9.5 对应 PHP 7.3–8.0，^10.0 才支持 PHP 8.1+

composer.json 的 autoload 配置怎么写才让测试能引用源码

测试代码需要加载你包里的类，但又不能靠 require 硬引——得靠 Composer 的自动加载机制。关键是把源码路径和测试路径都注册进 autoload 和 autoload-dev。

容易踩的坑：只配了 autoload，没配 autoload-dev；或者 psr-4 的命名空间前缀和实际目录结构对不上，导致 new MyPackageSomething() 在测试里报错。

立即学习“PHP免费学习笔记（深入）”；

Workflow Decomposer

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

下载

• "autoload": { "psr-4": { "MyPackage\": "src/" } }
• "autoload-dev": { "psr-4": { "MyPackage\Tests\": "tests/" } }
• 改完记得运行 composer dump-autoload，否则新配置不生效
• 测试类命名空间必须匹配 autoload-dev 的映射，比如 tests/Unit/ExampleTest.php 对应 MyPackageTestsUnitExampleTest

为什么 vendor/bin/phpunit 报错 “No tests executed”

不是没写测试，而是 PHPUnit 根本没扫描到你的测试文件。原因通常出在路径配置或文件命名上。

典型表现：命令执行成功但输出 OK (0 tests, 0 assertions)；或者报 Warning: No test files found。

• 检查 phpunit.xml 里 <testsuites> 是否指定了正确的 <directory>，例如 <directory>./tests</directory>
• 确认测试类继承了 PHPUnitFrameworkTestCase，且类名以 Test 结尾（如 ExampleTest），方法名以 test 开头或加了 @test 注解
• Windows 下路径分隔符有时会引发问题，建议统一用正斜杠 / 或用 ./tests 这种相对写法
• 如果用了 --filter 参数但拼写错误（比如大小写不符），也会静默跳过所有测试

怎么让 GitHub Actions 自动跑测试，且兼容不同 PHP 版本

本地能跑不等于 CI 能过。GitHub Actions 默认环境不带扩展（如 mbstring、xml），也不自动装 dev 依赖，得手动补全。

最容易被忽略的一点：没在 workflow 里显式运行 composer install，结果 vendor/bin/phpunit 根本不存在。

• 用 shivammathur/setup-php 动作，它能自动启用常用扩展，并支持多 PHP 版本矩阵
• 必须加步骤：运行 composer install --no-interaction --prefer-dist（--dev 默认开启，不用额外写）
• 测试命令别写死成 ./vendor/bin/phpunit，改用 php -d memory_limit=-1 vendor/bin/phpunit，避免内存溢出中断
• PHP 8.2+ 默认禁用动态属性，如果你的测试里用了 $obj->undefined_prop = 1，会直接 fail——得在 phpunit.xml 加 convertDeprecationsToExceptions="false" 或升级断言写法

测试真正难的不是写断言，是让类能加载、路径能对上、环境能复现。尤其当别人 fork 你的包想提 PR 时，一个配错的 autoload-dev 就能让整个测试流程卡住。