如何让PHPUnit代码覆盖率包含Laravel包测试中的Fixture文件？

1. 修正Composer自动加载配置 #

Fixture类的命名空间要和用户生成的类保持一致（即App\Models），所以在composer.json的autoload-dev中正确映射命名空间：

"autoload-dev": {
    "psr-4": {
        "YourPackage\\Tests\\": "tests/",
        "App\\": "tests/Fixtures/app/"
    }
}

执行命令更新自动加载缓存：

composer dump-autoload-dev

2. 调整PHPUnit配置文件 #

修改phpunit.xml，在<coverage>标签下的<include>中添加Fixture类所在目录，确保路径准确：

<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         colors="true">
    <!-- 其他配置项 -->
    <coverage processUncoveredFiles="true">
        <include>
            <!-- 包自身源码目录 -->
            <directory suffix=".php">src</directory>
            <!-- 添加Fixture模型目录 -->
            <directory suffix=".php">tests/Fixtures/app/Models</directory>
        </include>
    </coverage>
</phpunit>

• processUncoveredFiles="true"会确保未被测试覆盖的Fixture文件也被纳入统计（按需开启）。

3. 确保Fixture类在测试中被实际执行 #

覆盖率只统计被测试代码触发执行的类和方法，所以要在测试用例中明确调用Fixture类的逻辑，比如：

<?php

namespace YourPackage\Tests;

use App\Models\GeneratedPostModel;
use PHPUnit\Framework\TestCase;

class GeneratedModelTest extends TestCase
{
    public function test_model_basic_functionality()
    {
        $model = new GeneratedPostModel();
        // 调用模型方法，触发代码执行
        $this->assertEquals('posts', $model->getTable());
        $this->assertTrue($model->hasTimestamps());
    }
}

4. 清理PHPUnit缓存 #

如果配置修改后仍不生效，清理缓存再重新运行测试：

phpunit --no-cache
# 或者手动删除缓存目录
rm -rf .phpunit.cache

常见排查点 #

• 确认Fixture类的命名空间严格匹配App\Models\XXX，不要加Tests\Fixtures前缀。
• 检查phpunit.xml中的路径是否正确，确保项目根目录下的tests/Fixtures/app/Models真实存在。
• 运行测试时加--coverage-html coverage参数生成可视化报告，直接查看Fixture类是否出现在报告中，快速定位问题。

内容的提问来源于stack exchange，提问作者Zakalwe