PHPUnit中dg/bypass-finals钩子放置位置及类不存在报错解决方案

问题原因 #

类找不到是因为你定义的BypassFinalHook没有被PHPUnit运行时的自动加载器识别，加file参数报权限错误是路径配置错误或者文件可读权限不足。

解决方法 #

方法1：适配项目自动加载规则（推荐）

• 如果你项目的composer.json中配置了测试目录的PSR-4自动加载规则，例如：

{
  "autoload-dev": {
    "psr-4": {
      "App\\Tests\\": "tests/"
    }
  }
}

• 把BypassFinalHook.php文件移动到tests目录下，给类加上对应命名空间：

<?php declare(strict_types=1);
namespace App\Tests; // 新增命名空间声明

use DG\BypassFinals;
use PHPUnit\Runner\BeforeTestHook;

final class BypassFinalHook implements BeforeTestHook
{
   public function executeBeforeTest(string $test): void
   {
       BypassFinals::enable();
   }
}

• 修改phpunit.xml中扩展的类名为完整命名空间类名：

<phpunit bootstrap="vendor/autoload.php">
   <extensions>
      <extension class="App\Tests\BypassFinalHook"/>
   </extensions>
</phpunit>

• 执行composer dump-autoload刷新自动加载配置即可。

方法2：单独配置文件自动加载

• 不需要移动文件，直接在composer.json的autoload-dev中添加文件加载规则：

{
  "autoload-dev": {
    "files": ["BypassFinalHook.php"]
  }
}

• 执行composer dump-autoload后重新运行PHPUnit即可。

方法3：正确使用file参数配置

• 确保file属性的路径是相对于phpunit.xml所在目录的相对路径，比如两个文件都在项目根目录时配置如下：

<phpunit bootstrap="vendor/autoload.php">
   <extensions>
      <extension class="BypassFinalHook" file="./BypassFinalHook.php"/>
   </extensions>
</phpunit>

• 权限问题执行以下命令给文件加可读权限即可：

chmod 644 BypassFinalHook.php

更简化的替代方案

不需要单独写钩子类，直接在项目测试启动文件中启用bypass-finals即可：

1. 在项目根目录新建tests/bootstrap.php，内容如下：

<?php
require_once __DIR__ . '/../vendor/autoload.php';

DG\BypassFinals::enable();

2. 修改phpunit.xml的bootstrap配置：

<phpunit bootstrap="tests/bootstrap.php">
   <!-- 其他配置不变，不需要注册扩展 -->
</phpunit>

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