卸载PHP扩展的完整步骤详解

本文详细解析了卸载PHP扩展的完整流程，强调“卸载”实则分为安全禁用与彻底删除两个层次：先通过验证运行状态、注释配置或移除ini文件来停用扩展，再针对非内置扩展（如redis、xdebug）定位并删除.so文件及PECL安装记录；同时重点提醒多版本PHP共存、CLI/FPM/Apache配置隔离、Docker环境差异等易踩陷阱，指出真正难点在于精准识别当前PHP实例所依赖的配置路径与加载机制——操作再规范，漏掉任一环节都可能导致扩展“看似卸载实则照常运行”。

确认扩展是否已启用

卸载前先验证该扩展是否真正在运行，避免误操作。用 php -m 列出所有已加载模块，或运行 php -i | grep "extension_dir" 查看扩展存放路径，再结合 php --ri extname（如 php --ri mysqli）检查具体状态。

注意：有些扩展是编译进 PHP 的（如 json、mbstring），无法“卸载”，只能禁用；而通过 pecl install 或手动编译安装的扩展（如 redis、grpc）才可移除。

禁用扩展（最常用且安全的方式）

绝大多数场景下，“卸载”实际只需停用——修改 PHP 配置文件，让扩展不再加载。

• 找到主配置文件：php --ini 输出的 Loaded Configuration File 路径，通常是 /etc/php/*/cli/php.ini 或 /usr/local/etc/php/php.ini
• 搜索 extension= 行，注释掉对应扩展行，例如把 extension=redis.so 改成 ;extension=redis.so
• 若扩展是通过独立 .ini 文件启用的（如 Debian/Ubuntu 下的 /etc/php/*/mods-available/redis.ini），直接删除该文件或执行 phpenmod -v all -s ALL -r redis（Debian系）或 rm /etc/php.d/redis.ini（RHEL/CentOS）
• 改完后务必重启 Web 服务（systemctl restart apache2 或 systemctl restart php-fpm）或 CLI 环境

彻底删除扩展文件（仅适用于非内置扩展）

禁用只是不加载，文件仍留在磁盘上。要完全清理，需定位并删除其二进制文件和配置残留。

• 用 php-config --extension-dir 查扩展目录（如 /usr/lib/php/20220829/），进入后找对应 .so 文件（如 redis.so）并 rm 掉
• 检查是否有 PECL 安装记录：pecl list，若存在，执行 pecl uninstall extname（如 pecl uninstall xdebug）
• 留意多 PHP 版本共存情况：不同版本的 php.ini 和扩展目录可能分离，which php 和 php -v 必须与目标环境一致
• 某些扩展（如 ionCube Loader）会写入 php.ini 多行（含 zend_extension=），需一并清理，否则启动时报 Failed loading 错误

验证卸载结果与常见陷阱

完成操作后必须验证，不能只信配置改了就完事。

• CLI 下运行 php -m | grep -i redis（替换为你操作的扩展名），输出为空才表示成功禁用
• Web 环境中创建 phpinfo() 页面，搜索扩展名，确认无“enabled”字样；同时检查 Loaded Configuration File 是否是你修改的那个文件
• 常见坑：php.ini 有多个（CLI / FPM / Apache 模块各自独立）、扩展名拼写错误（gd.so vs gd）、路径权限问题导致 .so 文件删了但 PHP 还在缓存旧句柄（重启服务不彻底）
• 如果你用的是 Docker，记得重建镜像或确保 docker exec 进入的是正确容器，宿主机改配置对容器内无效

真正难的不是删文件，而是搞清当前 PHP 实例到底读哪个配置、加载哪些路径、由哪个进程托管——漏掉任一环节，扩展就还在后台跑着。

到这里，我们也就讲完了《卸载PHP扩展的完整步骤详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！