PHPUnit控制台中--uses参数的作用及使用方法咨询

核心用途 #

• 用于仅运行依赖指定资源、类或 trait 的测试用例，帮你快速筛选关联测试，跳过无关用例，提升针对性测试或调试的效率。
• 官方核心定义：

Only run tests that use the specified resource, class, or trait.

使用方法 #

• 基础语法：phpunit --uses <目标名称>
  • <目标名称> 需替换为要筛选的资源、类或 trait 的完整限定名（例如 App\Services\PaymentService）
• 实际示例：
  • 运行所有依赖 App\Traits\Cacheable trait 的测试：

    phpunit --uses App\Traits\Cacheable
    

  • 结合目录参数，只在单元测试目录中筛选依赖指定模型的测试：

    phpunit tests/Unit --uses App\Models\Order
    

关键注意点 #

• PHPUnit 识别的"依赖"场景包括：测试类直接继承目标类、使用目标 trait、测试代码中实例化目标类等多种关联情况。
• 若指定的名称不存在，或没有测试用例依赖它，PHPUnit 会返回无匹配测试的提示。

内容的提问来源于stack exchange，提问作者Alexander Leon Bulatov