PHP开启Gzip页面压缩的两种实现方式

理解Gzip压缩与前置条件

Gzip是一种常用的数据压缩格式，Web服务器可以通过它压缩响应内容（如HTML、CSS、JS），然后发送给客户端浏览器，由浏览器解压后显示。这能有效减少网络传输时间，尤其对文本类资源效果显著。

在进行任何配置之前，必须确认服务器环境满足以下两个核心条件：

• PHP编译时启用了zlib扩展：这是进行数据压缩的基础能力。
• 客户端支持gzip解码：绝大多数现代浏览器都默认支持Gzip，但需要在请求头中携带Accept-Encoding: gzip。

方法一：使用内置函数 ob_gzhandler

这是最简单且推荐的标准做法。PHP提供了一个内置的输出缓冲处理函数ob_gzhandler()，它可以自动检测客户端是否支持Gzip，并在支持的情况下进行压缩。

第1步：检查并启动输出缓冲

在PHP脚本的最顶部，首先判断zlib扩展是否加载，如果加载则启动输出缓冲并指定处理器为ob_gzhandler。

<?php
if (extension_loaded('zlib')) {
    ob_start('ob_gzhandler');
}
?>

第2步：正常输出页面内容

启动缓冲后，后续的HTML和PHP echo 内容都会先存入缓冲区，而不是直接发送给浏览器。此时可以正常编写HTML结构。

注意：在此阶段不要调用header()设置非标准编码头，除非有特殊需求，否则让ob_gzhandler自动处理Content-Type即可。

第3步：刷新缓冲并结束

在所有内容输出完毕后，关闭输出缓冲并发送结果。通常不需要手动调用ob_end_flush()来执行压缩，因为ob_gzhandler会在缓冲区关闭时自动处理压缩逻辑，但如果为了确保稳妥或在某些特殊框架中，可以在最后显式调用结束函数。

以下是完整的参考代码结构：

<?php
// 1. 开启压缩缓冲
if (extension_loaded('zlib')) {
    ob_start('ob_gzhandler');
}

// 设置标准的HTML头（可选，通常由框架或模板处理）
header("Content-type: text/html;charset=utf-8");
?>

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8"/>
    <title>Gzip测试页</title>
</head>
<body>
    <p>这是一段用于测试Gzip压缩效果的文本内容。</p>
    <!-- 大量重复内容有助于展示压缩效果 -->
    <?php for($i=0;$i<1000;$i++) { echo "Hello World!<br />"; } ?>
</body>
</html>

<?php
// 2. 结束缓冲，发送已压缩的内容
if (extension_loaded('zlib')) {
    ob_end_flush();
}
?>

方法二：自定义压缩函数

如果需要更精细地控制压缩过程，或者需要记录压缩前后的字节数以便监控，可以自定义一个输出缓冲回调函数。这种方法允许我们在压缩前后介入逻辑。

第1步：定义自定义回调函数

创建一个名为ob_gzip的函数。该函数接收未压缩的内容字符串作为参数。在函数内部，我们再次校验 headers 是否已发送、zlib 是否可用以及客户端是否支持 gzip。

// 自定义压缩回调函数
function ob_gzip($content) {
    // 只有当头部未发送、zlib存在且客户端接受gzip时才压缩
    if (!headers_sent() && extension_loaded("zlib") && strstr($_SERVER["HTTP_ACCEPT_ENCODING"], "gzip")) {
        $length = strlen($content);
        // 使用gzencode进行压缩，等级9为最高压缩率
        $content = gzencode($content, 9);
        
        // 设置必要的HTTP头
        header("Content-Encoding: gzip");
        header("Vary: Accept-Encoding"); // 告知代理服务器根据Accept-Encoding返回不同版本
        header("Content-Length: " . strlen($content));
    }
    return $content;
}

第2步：注册输出缓冲处理程序

在PHP文件的开始部分，调用ob_start()并将上面定义的函数名作为参数传入。

<?php
ob_start('ob_gzip');
?>

第3步：输出内容并刷新

编写页面内容，最后在脚本末尾关闭缓冲并发送内容。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8"/>
    <title>自定义Gzip测试</title>
</head>
<body>
    <p>使用自定义回调函数实现的Gzip压缩。</p>
</body>
</html>

<?php
ob_end_flush();
// 此处紧接着是上述自定义函数 ob_gzip 的定义
?>

关键注意事项与排错

Headers 已发送错误

如果在开启缓冲前就输出了空格、BOM头或调用了echo等实质性内容，会导致headers_sent()返回真，从而跳过压缩步骤。
解决方法：确保PHP文件开头没有任何多余字符，包括<?php标签之前的空白行或空格。

Content-Length 冲突

在方法二中，手动设置了Content-Length: 加上压缩后的长度。如果在之后又调用了其他可能会修改内容长度的函数，可能导致长度不匹配。通常ob_end_flush()会自动处理剩余缓冲区的长度，但在手动模式下需注意这一点。

Vary 头的重要性

务必设置Vary: Accept-Encoding头。这是因为CDN或反向代理服务器（如Nginx、Varnish）会根据此头缓存不同的版本：一个是原始的HTML，另一个是Gzip压缩后的HTML。如果不设此头，代理服务器可能错误地将未压缩的版本发给不支持Gzip的老旧浏览器，或反之，导致乱码或大流量。

验证压缩是否生效

完成代码部署后，可以通过以下方式验证：

1. 查看响应头：打开浏览器的开发者工具（F12）→ Network → 点击页面请求 → 查看 Response Headers。如果看到Content-Encoding: gzip，说明成功开启。
2. 对比体积：观察 Request/Response 中的 Size，压缩后的体积通常会比原始HTML小很多。

以上就是PHP开启Gzip页面压缩功能的详细内容，更多关于PHP性能优化的资料请关注本站其它相关文章！