部署PHPWord项目至服务器后提示PhpOffice\PhpWord\TemplateProcessor.php缺失怎么办

1. 验证依赖文件完整性 #

• 首先检查服务器上PHPWord的安装路径下是否存在目标文件：如果是composer安装的，路径应为vendor/phpoffice/phpword/src/PhpOffice/PhpWord/TemplateProcessor.php。绝大多数此类问题都是部署时漏传了vendor目录，或仅上传了部分依赖文件导致。
• 如果使用git部署项目，检查.gitignore文件是否将vendor目录加入了忽略规则，导致拉取代码时没有同步依赖包。
• 优先在服务器项目根目录执行composer install --no-dev重新安装生产环境依赖，避免手动传输文件出现的漏传、错传问题。

2. 排查自动加载配置 #

• 确认项目入口代码中已经正确引入composer自动加载文件，示例代码如下：

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

注意路径要和你项目实际的vendor目录位置匹配，本地和服务器的目录结构差异可能会导致自动加载文件引入失败。

• 如果你使用的是自定义自动加载规则，检查PhpOffice\PhpWord命名空间的映射路径是否正确指向PHPWord的src目录，报错提示在includes文件夹中查找文件，说明你的自动加载规则默认去includes目录加载类，要么调整映射规则，要么将PHPWord的src/PhpOffice目录整体移动到includes目录下即可。

3. 检查大小写兼容问题 #

• Windows、Mac本地环境默认文件名大小写不敏感，而Linux服务器大小写敏感。检查类名拼写、目录名大小写是否和官方PHPWord的结构完全一致，例如避免将TemplateProcessor写为templateprocessor、PhpOffice写为phpoffice等错误。

4. 验证PHP版本兼容性 #

• 确认服务器PHP版本符合你使用的PHPWord版本要求，最新版PHPWord要求PHP >= 7.1，版本过低会导致依赖加载失败，抛出类不存在错误。

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