Composer扩展包怎么开发单元测试流程-composer-PHP中文网

composer包单元测试需严格隔离：require-dev与autoload-dev必须配对，autoload-dev声明测试路径（如"yourpackage ests": "tests/"），并执行composer dump-autoload；phpunit.xml.dist的bootstrap必须为vendor/autoload.php；测试类命名、目录结构须严格匹配psr-4，且应在包自身目录下运行测试。

composer扩展包怎么开发单元测试流程

Composer扩展包的单元测试不是“加个phpunit就行”，核心在于隔离包自身逻辑、不依赖宿主项目，且测试入口必须能独立加载包的类。

composer.json 里 require-dev 和 autoload-dev 必须配对

只写 "phpunit/phpunit": "^9.5" 到 require-dev 不够，autoload-dev 没配会导致测试类找不到被测类。常见错误是运行 ./vendor/bin/phpunit 报 Class "YourPackageCalculator" not found。

autoload 声明源码自动加载（如 "psr-4": {"YourPackage\": "src/"}）
autoload-dev 必须声明测试代码路径（如 "psr-4": {"YourPackage\Tests\": "tests/"}），否则 PHPUnit 加载测试类时无法反向解析被测类的命名空间
改完 composer.json 后必须执行 composer dump-autoload，否则新配置不生效

phpunit.xml.dist 的 bootstrap 要指向 vendor/autoload.php

不能用 src/autoload.php 或自定义引导文件——Composer 包的测试环境必须复用 Composer 自动生成的自动加载逻辑，否则 PSR-4 映射会失效。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

bootstrap="vendor/autoload.php" 是唯一可靠方式
如果包有特殊初始化逻辑（比如注册全局函数），应放在 tests/bootstrap.php 中，并在 phpunit.xml.dist 里通过 bootstrap="tests/bootstrap.php" 引入，且该文件第一行必须是 require_once __DIR__ . '/../vendor/autoload.php';
别在测试类里手动 require 或 include 源文件，这会绕过自动加载，导致覆盖率统计失败

测试类命名和目录结构要严格匹配 PSR-4

PHPUnit 会根据测试类名反推被测类路径，一旦错位就无法运行或断言失败。例如：YourPackageTestsUnitCalculatorTest 类默认对应 YourPackageCalculator 类。

测试类文件必须放在 tests/Unit/ 下，且命名以 Test 结尾（如 CalculatorTest.php）
类名必须与文件名一致，且命名空间要包含 Tests 子段（如 namespace YourPackageTestsUnit;）
被测类在 src/ 下的路径必须与命名空间完全一致（src/Calculator.php → namespace YourPackage;），否则 createMock() 或 getMockForAbstractClass() 会报错

本地开发时别直接在宿主项目里跑测试

在 Laravel 项目或普通 PHP 项目中 composer require your/package:dev-main 后，直接进 vendor/your/package 目录跑 phpunit 是最干净的验证方式。若在宿主项目根目录运行 phpunit，容易混入宿主项目的 autoloader、配置甚至数据库连接，导致测试行为失真。

进入包目录后，确保当前 composer.json 是包自身的，不是宿主项目的
运行 ./vendor/bin/phpunit --testdox 可读性更强，失败时会显示具体哪个 test* 方法挂了
CI 环境（如 GitHub Actions）应使用 cd packages/your-package && composer install && ./vendor/bin/phpunit 这种显式路径，避免工作目录误判

真正容易被忽略的是：Composer 包的单元测试本质上是一次“脱离上下文”的验证——它不关心你用不用 Laravel、是否连了 Redis、有没有 .env 文件。任何试图在测试中读取宿主项目配置、调用 app() 或 config() 的写法，都已越界到集成测试范畴，应该用单独的 tests/Integration/ 目录承载。