自制WordPress插件部署后报MongoDB\Driver\Manager类未找到错误

问题重现 #

开发的WordPress插件用于连接MongoDB Atlas并比对表单数据，本地运行正常，上传至WordPress激活时触发致命错误：

Fatal error: Uncaught Error: Class "MongoDB\Driver\Manager" not found in C:\...\vendor\mongodb\mongodb\src\Client.php:126

错误触发于连接代码行：

$mongoClient = new MongoDB\Client('mongodb+srv://XXXX:XXXX@cluster0.XXXX.mongodb.net/test?retryWrites=true&w=majority');

核心原因与解决步骤 #

虽然你提到已安装MongoDB PHP驱动和库，但线上WordPress环境的配置和本地存在差异，按以下步骤排查：

1. 确认线上服务器的MongoDB PHP扩展已启用

   • 该错误最常见的原因是二进制PHP扩展未安装/启用（注意：MongoDB PHP扩展不是Composer包，是需要编译/安装的系统级扩展）
   • 验证方法：在WordPress根目录新建phpinfo.php，内容为<?php phpinfo(); ?>，访问后搜索mongodb，确认扩展存在且启用
   • 若未启用，需在服务器的php.ini中添加extension=mongodb.so（Linux）或extension=mongodb.dll（Windows），并重启Web服务

2. 确保插件已正确引入Composer自动加载

   • 本地用Composer安装的mongodb库依赖vendor/autoload.php加载类，上传插件时必须将vendor目录一起上传
   • 在插件的主PHP文件开头，手动引入自动加载文件：

     require_once plugin_dir_path(__FILE__) . 'vendor/autoload.php';
     

   • WordPress不会自动加载插件目录下的Composer自动加载文件，必须显式引入

3. 核对线上与本地的PHP版本

   • MongoDB PHP扩展和官方库对PHP版本有要求（如PHP 7.4+），若线上PHP版本低于本地，会导致类加载失败
   • 用php -v命令查看线上PHP版本，确保和本地一致或满足库的版本要求

4. 检查命名空间引用（可选）

   • 若上述步骤都完成仍报错，可尝试在Client.php中使用全局命名空间前缀引用Manager类：

     $this->manager = new \MongoDB\Driver\Manager($uri, $uriOptions, $driverOptions);
     

   • 这是因为WordPress的环境可能存在命名空间冲突，显式指定全局命名空间可解决问题

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