因版本不兼容、弃用MongoDB或环境调整需卸载PHP Mongo扩展，Linux系统可通过pecl uninstall mongodb或手动删除mongodb.so及php.ini中的extension=mongodb配置；Windows系统需在php.ini注释/删除对应行，并移除php_mongodb.dll文件，操作前建议备份配置文件，卸载后重启PHP服务（如Apache/Nginx），通过phpinfo()检查确认扩展已完全移除，避免影响其他PHP功能。
PHP MongoDB扩展卸载全指南：步骤、注意事项与常见问题解决
在PHP开发中,MongoDB扩展是连接MongoDB数据库的核心组件，当项目需求变化（如迁移数据库、升级PHP版本、或替换为新的驱动）时，彻底卸载该扩展成为必要操作。**不当的卸载可能导致PHP环境异常、服务启动失败或依赖冲突**，本文将系统介绍不同环境下的卸载步骤、关键注意事项及常见问题解决方案，确保开发者安全高效地完成扩展移除。
卸载前准备
执行卸载前,务必完成以下准备工作，避免操作中断或环境损坏：
-
确认扩展安装方式
MongoDB扩展的安装方式直接影响卸载策略，常见安装路径包括：
- PECL（PHP扩展库）
- 源码编译安装
- 系统包管理器（如apt、yum）
- 手动上传DLL/SO文件
**操作前需通过以下命令确认安装状态**：php -m | grep mongo # 检查扩展是否已加载 php --info | grep "MongoDB" # 显示扩展路径及版本信息
-
备份关键配置文件
MongoDB扩展的配置通常存储在php.ini中（路径示例：/etc/php/7.4/cli/php.ini、/etc/php.ini或 Windows 的C:\php\php.ini）。**建议备份该文件**，以便后续恢复或参考配置格式。 -
停止相关服务
若PHP运行于Web服务器（Apache/Nginx）或PHP-FPM，需提前停止服务以避免文件占用冲突：sudo systemctl stop apache2 # 停止Apache sudo systemctl stop php-fpm # 停止PHP-FPM sudo systemctl stop nginx # 若使用Nginx
不同环境下的卸载步骤
（一）Linux/macOS环境
通过PECL卸载（推荐）
若扩展通过PECL安装,执行以下命令：
sudo pecl uninstall mongodb # 新版扩展名 sudo pecl uninstall mongo # 旧版扩展名（PHP 7.3及以下）
**PECL会自动清理扩展文件并更新php.ini配置**（若扩展由pecl install自动注册）。
通过源码编译卸载
手动编译安装的扩展需手动清理：
- 定位扩展文件：
执行php --info | grep "extension_dir"获取扩展目录（如/usr/lib/php/modules/），删除其中的mongodb.so或mongo.so。 - 清理php.ini：
编辑php.ini，删除或注释以下行：
extension=mongodb.so # 或 extension=mongo.so
- 清理编译临时文件：
删除源码编译的临时目录（通常位于/tmp/pear/temp/mongodb）。
通过系统包管理器卸载
根据系统选择对应命令：
- Debian/Ubuntu：
sudo apt remove php-mongodb # 新版 sudo apt remove php-mongo # 旧版
- CentOS/RHEL：
sudo yum remove php-pecl-mongodb # 新版 sudo yum remove php-pecl-mongo # 旧版
**包管理器会自动删除扩展文件，但需手动检查php.ini残留配置**（部分系统可能未自动清理）。
（二）Windows环境
-
删除扩展文件
- 定位PHP安装目录（如C:\php\），进入ext子目录。
- 删除以下DLL文件：
php_mongodb.dll（新版）或php_mongo.dll（旧版）
- **若扩展位于其他目录**（如System32），需一并删除（通过php --info确认路径）。 -
编辑php.ini
用文本编辑器打开php.ini（路径：C:\php\php.ini或C:\Windows\php.ini），删除或注释以下行：extension=php_mongodb.dll # 或 extension=php_mongo.dll
-
重启PHP相关服务
- **Apache**：通过XAMPP/WAMP控制面板或命令行重启：
net stop apache2 && net start apache2
- **PHP-FPM**：重启服务（需重新加载配置）：
npm restart php-fpm
- **命令行PHP**：关闭当前终端后重新打开。
卸载后验证
执行以下命令确认扩展已完全移除：
php -m | grep mongo # 无输出表示扩展已卸载 php --info | grep "MongoDB" # 无输出表示配置已清理
**若仍有输出**，需检查：
- php.ini中是否残留扩展配置
- 扩展文件是否未完全删除（如ext目录或System32）
- 多PHP版本环境需切换到对应版本验证
