PHP动态生成图片无法CDN缓存：利用HTTP 304解决

问题分析：为什么动态图片不缓存？

CDN的缓存原理依赖于HTTP响应头中的缓存控制指令。如果PHP脚本在处理图片后，没有明确设置`Cache-Control`、`Expires`等缓存头部，或者没有正确实现条件请求（Conditional Request）验证（即Etag/Last-Modified校验），浏览器和CDN边缘节点通常会认为该资源“不可缓存”或“每次都需验证”，从而直接回源获取最新数据。

对于动态生成的图片，由于文件名可能相同但内容可能随参数变化，我们需要一种机制来告诉客户端：“如果你之前已经下载过这个版本，且你本地有对应的校验标识，那么请直接使用本地副本，无需我重新传输内容。”这就是HTTP 304状态码的作用。

解决方案：在PHP中实现HTTP缓存头与304判断

要在PHP中实现这一逻辑，主要依靠两个步骤：一是计算资源的唯一标识（通常使用Etag）；二是在每次请求开始时检查客户端是否发送了相应的校验头（如`If-None-Match`），若匹配则终止输出并返回304。

第1步：准备与引入依赖

确保你的PHP环境可以访问全局超全局变量`$_SERVER`。此方案不需要额外的第三方库，完全基于原生的HTTP头处理函数。

第2步：编写304检测与响应代码

在处理图片输出（如`echo $image_data;`）之前，插入以下校验逻辑：

// 定义当前生成内容的唯一标识（这里以文件内容MD5为例）
// 实际场景中，可根据图片ID、尺寸参数组合生成唯一字符串
$etag_value = md5($this->image);

// 检查客户端是否携带了 If-None-Match 头
if (isset($_SERVER['HTTP_IF_NONE_MATCH'])) {
    // 比较服务器端计算的 ETag 与客户端携带的 ETag
    if ($_SERVER['HTTP_IF_NONE_MATCH'] === $etag_value) {
        // 内容未修改，发送 304 状态码，并立即退出后续输出
        header("HTTP/1.1 304 Not Modified", true, 304);
        exit;
    }
}

第3步：设置标准缓存响应头

如果客户端没有要求304（即首次访问或校验失败），则需要正常输出图片数据，并附带告诉浏览器/CDN这段内容可以缓存一段时间。关键代码如下：

// 1. 设置 Last-Modified（建议设置为一个合理的过去时间或固定时间，避免频繁验证）
// 注意：gmdate 用于生成符合 HTTP 标准的 GMT 时间格式
header('Last-Modified: ' . gmdate('D, d M Y H:i:s', strtotime('2011-01-01')) . ' GMT');

// 2. 设置 ETag（必须与上面校验使用的值一致）
header('ETag: ' . $etag_value);

// 3. 设置 Cache-Control
// max-age=2592000 表示允许缓存 30 天（2592000秒）
header('Cache-Control: max-age=2592000, public');

// 4. 设置 Content-Type（根据实际图片类型调整）
header('Content-Type: image/jpeg');

// 5. 最后输出图片二进制流
echo $this->image;

第4步：验证效果

部署代码后，可以通过浏览器开发者工具（Network面板）查看网络请求：

• 第一次访问：返回200状态码，完整传输图片大小。
• 刷新或再次访问：如果未过期，可能会看到请求头中带`If-None-Match`，服务器返回304 Not Modified，响应大小为0KB（或仅包含Header）。此时CDN也会将此URL纳入缓存列表。

Nginx配置注意事项

部分用户反映在PHP中获取不到`$_SERVER['HTTP_IF_NONE_MATCH']`，这通常与Web服务器（如Nginx）的环境变量传递有关。虽然现代Nginx默认会将Client Header转换为`HTTP_XXX`形式放入`$_SERVER`，但在某些FastCGI配置下可能需要显式声明。

如果在调试中发现`$_SERVER`中缺失相关变量，可尝试在`nginx.conf`或`conf/fastcgi.conf`中确保包含了如下映射（大多数现代版本默认已支持，除非进行了严格的自定义过滤）：

fastcgi_param CACHE_ETAG "$http_if_none_match";

更通用的做法是直接使用Nginx默认的转换规则，确保PHP通过`$_SERVER['HTTP_IF_NONE_MATCH']`读取即可，无需强制重命名变量名。

总结

解决PHP动态图片无法被CDN缓存的核心，在于服务端主动配合HTTP协议进行“协商缓存”。通过计算内容的Etag，并在请求中比对`If-None-Match`，配合正确的`Cache-Control`头部，可以让浏览器和CDN节点有效地复用本地或边缘缓存，从而大幅减轻后端服务器的IO压力和带宽消耗。以上就是PHP动态图片CDN缓存优化的详细内容，更多关于PHP HTTP协议与服务器优化的资料请关注本站其它相关文章！