CodeIgniter4无法连接MongoDB：安装MongoDB PHP驱动遇报错求助

核心问题排查与解决方案 #

1. 版本匹配问题（最常见） #

• 先确认当前PHP版本：执行命令 php -v 获取完整版本号，同时注意系统架构（x86/x64）、线程安全模式（TS/NTS）
• 去MongoDB官方驱动页面下载完全匹配的mongodb.dll文件（PHP 7.4+版本不再支持旧版mongo.dll）

2. 驱动部署与配置 #

• 将下载的mongodb.dll放到PHP安装目录的ext文件夹内
• 打开php.ini，添加一行配置：extension=mongodb（无需加.dll后缀，部分PHP版本会自动识别）
• 重启Web服务器（Apache/Nginx）或PHP-FPM服务，确保配置生效

3. 依赖库缺失修复 #

Windows系统下MongoDB驱动依赖libsasl.dll，如果系统缺少该文件：

• 从PHP安装目录的dev子文件夹中找到该文件，复制到Windows/System32（64位系统可同步放到Windows/SysWOW64）
• 或直接从MongoDB驱动配套压缩包中提取对应依赖文件

4. 安装验证 #

• 创建PHP测试文件，写入代码：

<?php phpinfo(); ?>

访问该文件，搜索mongodb，若出现模块信息则安装成功；也可执行命令 php -m，查看输出列表中是否包含mongodb

CodeIgniter4连接配置 #

驱动安装成功后，在项目.env文件中配置MongoDB连接：

database.default.DBDriver = MongoDB
database.default.hostname = localhost
database.default.database = 你的数据库名
database.default.username = 你的用户名
database.default.password = 你的密码
database.default.port = 27017

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