PHPWord 0.18.2与PHPStan集成问题求助：类引用大小写错误

云上老周

2026-7-15

PHPWord 0.18.2 PHPStan大小写警告解决办法

针对PHPStan抛出的Class PhpOffice\PhpWord\Writer\PDF\MPDF referenced with incorrect case: PhpOffice\PhpWord\Writer\PDF\Mpdf.警告，提供以下可行解决方案：

忽略特定警告
在项目根目录的phpstan.neon或phpstan.neon.dist配置文件中，添加规则忽略该大小写错误：
```
parameters:
    ignoreErrors:
        - '#Class PhpOffice\\PhpWord\\Writer\\PDF\\MPDF referenced with incorrect case: PhpOffice\\PhpWord\\Writer\\PDF\\Mpdf.#'
```
配置后PHPStan会跳过这条特定警告。
复用官方PHPStan配置
找到PHPWord 0.18.2源码中的phpstan.neon.dist文件，将其内容复制到你项目的PHPStan配置文件里。官方配置已经处理了这类内部大小写兼容问题，直接复用即可消除警告。
修正代码中的类名大小写
检查项目中引用该PDF写入类的代码，把错误的MPDF改为正确的Mpdf：
比如将：
```
use PhpOffice\PhpWord\Writer\PDF\MPDF;
```
修改为：
```
use PhpOffice\PhpWord\Writer\PDF\Mpdf;
```
实例化类时同步修正写法，从根源解决大小写不匹配问题。
升级PHPWord版本
若项目依赖允许，尝试将PHPWord升级至0.18.2以上版本。新版本大概率修复了类名大小写不一致的问题，同时能带来其他稳定性优化。