Laravel9+PHP8.2生成PHPUnit HTML覆盖率报告遇readonly类语法错误求助

问题根源 #

PHPUnit 9.x 及配套的 phpunit/php-code-coverage: ^9.2 版本是为 PHP <= 8.1 开发的，不支持 PHP 8.2 新增的 readonly 类语法，因此在解析包含该语法的代码时会抛出语法错误。

解决方案 #

方案一：升级PHPUnit及代码覆盖率组件（推荐长期方案） #

Laravel 9 兼容 PHPUnit 10.x 版本，而 PHPUnit 10.x 和对应的 phpunit/php-code-coverage: ^10.0 已完全支持 PHP 8.2 的 readonly 类语法。

操作步骤：

1. 修改项目根目录的 composer.json，更新依赖版本：

   {
       "require-dev": {
           "phpunit/phpunit": "^10.0",
           "phpunit/php-code-coverage": "^10.0"
       }
   }
   

2. 执行 composer 更新命令：

   composer update phpunit/phpunit phpunit/php-code-coverage --with-all-dependencies
   

3. 若出现配置兼容问题，可参考PHPUnit 10.x文档调整 phpunit.xml（例如部分配置项名称变更，bootstrap 改为 bootstrap-file）。

方案二：临时排除readonly类的覆盖率统计（快速 workaround） #

如果暂时无法升级PHPUnit，可以在覆盖率配置中排除包含 readonly 类的文件或目录，避免解析报错。

修改 phpunit.xml 中的 <filter> 节点：

<filter>
    <whitelist processUncoveredFilesFromWhitelist="true">
        <directory suffix=".php">./app</directory>
        <exclude>
            <!-- 替换为你的readonly类所在路径 -->
            <file>./app/Models/ReadOnlyUser.php</file>
            <directory>./app/ReadOnlyEntities</directory>
        </exclude>
    </whitelist>
</filter>

方案三：切换代码覆盖率驱动为PCOV #

若使用Xdebug作为覆盖率驱动，可尝试切换为PCOV，它对新PHP语法的支持通常更及时：

1. 安装PCOV扩展（通过PECL或源码编译）
2. 在 phpunit.xml 中指定驱动：

   <phpunit>
       <!-- 其他配置 -->
       <coverage driver="pcov">
           <!-- 覆盖率相关配置 -->
       </coverage>
   </phpunit>
   

注意：此方案仅作为临时尝试，长期来看仍建议升级PHPUnit版本。

内容的提问来源于stack exchange，提问作者juan manuel Sivianes Guisasola