如何解决phpMyAdmin提示未启用Zlib压缩_PHP.ini扩展加载教程-phpMyAdmin-PHP中文网

PHP未加载zlib扩展导致phpMyAdmin报“未启用Zlib压缩”错误，需分别验证CLI和Web环境的zlib启用状态，按部署方式启用扩展并重启对应服务。

PHP 未加载 zlib 扩展导致 phpMyAdmin 报错

phpmyadmin 提示“未启用 zlib 压缩”，本质是 php 运行时找不到 zlib 扩展，不是 phpmyadmin 配置问题，也不是浏览器或 nginx/apache 设置错误。只要 php cli 和 web sapi（如 fpm 或 apache 模块）都启用了 zlib，提示就会消失。

确认 zlib 是否真的没加载

别急着改配置，先验证问题是否真实存在：

运行 php -m | grep zlib，有输出说明 CLI 已加载；
新建 info.php，内容为 <?php phpinfo(); ?>，通过浏览器访问，搜索 “zlib” —— 若没出现 “zlib support => enabled”，说明 Web 环境未启用；
常见误区：CLI 有 zlib，但 php-fpm 或 Apache 的 PHP 模块用的是另一份 php.ini，路径可能不同（如 /etc/php/8.2/fpm/php.ini vs /etc/php/8.2/cli/php.ini）。

启用 zlib 的三类典型场景

根据你的 PHP 部署方式选择对应操作，不是所有情况都要改 php.ini：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Debian/Ubuntu + APT 安装 PHP：zlib 通常随 php-common 自动安装，但扩展需显式启用。检查 /etc/php/*/mods-available/zlib.ini 是否存在，再确认对应 SAPI 的 conf.d 是否软链过去（如 /etc/php/8.2/fpm/conf.d/20-zlib.ini）；
CentOS/RHEL + Remi 仓库：扩展包名可能是 php-zlib，需先 yum install php-zlib，再确保 extension=zlib 在生效的 php.ini 中未被注释；
源码编译 PHP：若 configure 时没加 --with-zlib，必须重新编译；仅靠修改 php.ini 添加 extension=zlib.so 会报错 Unable to load dynamic library 'zlib.so'。

改完 php.ini 后必须重启的服务

改了配置不重启等于白改，且不同部署方式要重启的对象不同：

Apache + mod_php：重启 apache2 或 httpd；
PHP-FPM + Nginx：重启 php8.2-fpm（版本号按实际替换），不是只重启 Nginx；
Docker 环境：容器内改了 php.ini，必须重建容器或至少 docker exec -it xxx kill -USR2 1（若使用 FPM）；直接 touch 或热重载无效；
Windows + Apache：注意 php_zlib.dll 路径是否在 extension_dir 下，且 extension=php_zlib.dll 不能写成 extension=zlib。