Laravel框架Gzip怎么开_Laravel框架传输压缩优化【说明】-php教程-PHP中文网

Gzip压缩必须由Web服务器（Nginx/Apache）在响应发出前完成，Laravel作为PHP应用层框架无法直接启用——因其生成原始响应体，而gzip属HTTP传输层压缩，发生在PHP输出之后；手动调用ob_gzhandler或启用zlib.output_compression易引发双重压缩、乱码或ERR_CONTENT_DECODING_FAILED，且不可靠。

laravel框架gzip怎么开_laravel框架传输压缩优化【说明】

Gzip 压缩在 Laravel 中默认不开启，也不能靠 Laravel 自身中间件或配置直接启用 —— 它必须由 Web 服务器（Nginx / Apache）在响应发出前完成压缩。

为什么 Laravel 自带的 `Response` 或中间件无法开启 Gzip

Laravel 是 PHP 应用层框架，它生成的是未压缩的原始响应体；gzip 是 HTTP 传输层压缩，发生在 PHP 输出之后、数据离开服务器之前。即使你在控制器里手动调用 ob_gzhandler 或 gzencode，也容易与 Web 服务器冲突，导致双重压缩、乱码或 ERR_CONTENT_DECODING_FAILED。

PHP 的 zlib.output_compression 在 Laravel 中不可靠：它可能被 ob_end_clean() 类函数中断，且无法精细控制 MIME 类型白名单
Laravel 的 Response::withHeaders() 加 Vary: Accept-Encoding 没用 —— 压缩本身没发生，只加头会误导浏览器
所有基于 StreamedResponse 或文件下载的响应，不应被 gzip 压缩（比如 PDF、ZIP），Web 服务器需按 Content-Type 过滤

Nginx 开启 Gzip 的最小可靠配置

在站点 server 块中添加以下配置（不是放在 http 全局块，避免影响 FastCGI 管道）：

gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
gzip_comp_level 6;

gzip_vary on 必须开启，否则 CDN 或代理可能缓存未压缩版本并错误返回给支持 gzip 的客户端
gzip_min_length 1024 避免对极小响应（如空 JSON {}）浪费 CPU 压缩，Laravel 路由返回的 HTML/JS/CSS 通常远超此值
不要加 application/vnd.api+json 或自定义 MIME 类型，除非你确认前端明确接受并解压；Laravel API 默认用 application/json，已包含在 gzip_types 里
别设 gzip_comp_level 9 —— Level 6 是压缩率和 CPU 时间的合理平衡点，Level 9 在高并发下可能拖慢响应

Apache 开启 Gzip 的关键模块与配置

确保 mod_deflate 已启用（Ubuntu 下执行 a2enmod deflate），并在虚拟主机或 .htaccess 中写：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

<ifmodule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript
    DeflateCompressionLevel 6
    SetOutputFilter DEFLATE
</ifmodule>

AddOutputFilterByType 是核心，只对指定类型生效；Laravel 的 text/html 响应默认被包含，但如果你用 response()->stream() 返回非标准类型，需手动补上
避免在 .htaccess 中用 SetEnvIfNoCase 匹配 User-Agent 来开关 gzip —— 现代浏览器全支持，没必要做兼容降级
Apache 下 DeflateCompressionLevel 范围是 1–9，同 Nginx，6 是推荐值

验证 Gzip 是否真正生效的三步检查法

别只看 Chrome DevTools 的 Content-Encoding: gzip 响应头 —— 它可能来自上游 CDN 或反向代理，而非你的 Laravel 服务器。

用 curl -H "Accept-Encoding: gzip" -I https://yoursite.com/ 直连服务器 IP（绕过 CDN），确认返回含 Content-Encoding: gzip 且 Content-Length 显著变小
检查响应 body 是否可解压：curl -H "Accept-Encoding: gzip" https://yoursite.com/ | gunzip -t —— 若报 gzip: stdin: not in gzip format，说明根本没压缩
用 ngrep -d any 'GET|HTTP' port 80 抓包，过滤出原始响应体长度，对比未压缩时的大小，确认压缩率在 60%~85% 区间（文本类资源典型值）

最常被忽略的一点：修改 Nginx/Apache 配置后，必须 reload 服务（sudo nginx -s reload 或 sudo systemctl reload apache2），而不是重启 PHP-FPM —— 后者对 Gzip 完全无影响。