Nginx配置启用Gzip是PHP-FPM架构下最优方案,需在http块中设置gzip on、指定types(含application/x-httpd-php)、调整level与min_length,并重载配置验证Content-Encoding头。

如果您正在使用 Nginx 与 PHP-FPM 构建 PHP 网站,但页面加载速度较慢、传输体积偏大,则很可能是响应内容未启用 Gzip 压缩。以下是针对该架构下启用 Gzip 压缩的多种可行方法:
一、通过 Nginx 主配置或站点配置启用 Gzip
此方式由 Nginx 在响应发送前统一压缩所有符合条件的动态与静态内容,不依赖 PHP 执行过程,性能最优且资源开销最低。Nginx 对 PHP-FPM 返回的 text/html、application/x-httpd-php 等类型响应同样适用压缩规则。
1、打开 Nginx 的主配置文件 /etc/nginx/nginx.conf 或对应站点的配置文件(如 /etc/nginx/conf.d/your-site.conf)。
2、在 http { ... } 块内(非 server 或 location 块),插入以下配置段:
gzip on;
gzip_min_length 1k;
gzip_buffers 16 8k;
gzip_http_version 1.1;
gzip_comp_level 5;
gzip_types text/plain text/css text/javascript application/javascript application/json application/xml application/xhtml+xml text/xml application/x-httpd-php;
gzip_vary on;
gzip_disable "MSIE [1-6]\.";
3、保存文件后执行 sudo nginx -t 验证语法是否正确。
4、若测试通过,运行 sudo nginx -s reload 重载配置使生效。
二、通过宝塔面板图形化界面启用 Gzip
该方式适用于使用宝塔控制面板管理 Nginx+PHP-FPM 站点的用户,无需手动编辑配置文件,所有操作均通过 Web 界面完成,避免语法错误与权限问题,适合运维经验较少的使用者。
1、登录宝塔面板,在左侧菜单中点击【网站】。
2、在网站列表中找到目标 PHP 站点,点击其右侧的【设置】按钮。
3、切换至【GZIP 压缩】选项卡。
4、勾选【启用 GZIP 压缩】复选框。
5、确认下方 MIME 类型列表已包含 text/html、text/css、application/javascript、application/x-httpd-php 等关键项(默认通常已包含)。
6、点击【保存】,系统将自动重载 Nginx 配置。
三、在 PHP 脚本中调用 ob_gzhandler 启用压缩
此方式在 PHP 层级动态启用输出缓冲压缩,适用于无法修改服务器配置的共享主机环境,或仅需对特定 PHP 页面启用压缩的场景。它依赖客户端请求头中的 Accept-Encoding 字段协商,仅对文本类响应生效,且必须置于脚本最顶端无任何前置输出位置。
1、在 PHP 文件第一行(任何 HTML、echo、空白字符或 BOM 字节之前)插入以下代码:
2、确保当前 PHP 环境已启用 zlib 扩展:可通过 phpinfo() 页面查找 zlib.version 是否存在且非空。
3、避免与其它输出控制函数嵌套,例如不得在同一脚本中重复调用 ob_start() 或同时启用 zlib.output_compression。
4、正常输出 HTML 内容,脚本结束时 PHP 自动触发压缩并发送响应。
四、通过 php.ini 全局启用 zlib.output_compression
该方式在 PHP 解释器层面强制对所有输出启用压缩,适用于拥有服务器 root 权限且希望统一管控的场景。但因其作用于全部响应(含二进制文件),易导致图片、PDF 等非文本内容损坏,故需谨慎启用并配合类型过滤逻辑(实际中常被弃用)。
1、执行 php --ini 或创建 phpinfo.php 查看 Loaded Configuration File 路径。
2、使用文本编辑器打开对应 php.ini 文件,搜索 zlib.output_compression。
3、将其值设为 On,若该行被分号注释则需去掉分号。
4、可选:查找 zlib.output_compression_level 并设为 6(推荐范围 1–9)。
5、保存后重启 PHP-FPM 服务:sudo systemctl restart php-fpm;若使用 Nginx,还需重启 Nginx 或至少重载配置。
五、验证 Gzip 是否已生效
无论采用何种方式,都必须通过真实 HTTP 请求响应头确认压缩实际生效,而非仅依赖配置存在。验证过程需模拟客户端声明支持 gzip,并比对压缩前后响应体大小差异。
1、在终端执行命令:curl -H "Accept-Encoding: gzip" -I https://your-domain.com/test.php。
2、检查返回头中是否存在 Content-Encoding: gzip 字段。
3、进一步对比压缩效果:执行 curl -H "Accept-Encoding: gzip" -s https://your-domain.com/test.php | wc -c 与 curl -H "Accept-Encoding:" -s https://your-domain.com/test.php | wc -c,确认前者字节数显著减少。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











