php 8.6公开json接口可以根据最终响应字节生成etag,get或head请求的if-none-match匹配时返回304且不发送正文。这个示例只用于不含用户私有信息的固定公开数据;登录态、权限或语言会改变响应时,必须重新设计缓存键与缓存策略,不能直接照搬public缓存。

PHP官方header手册要求在输出正文前发送响应头
先生成最终字节,再比较条件头
<?php
$method = $_SERVER['REQUEST_METHOD'] ?? 'GET';
if (!in_array($method, ['GET', 'HEAD'], true)) {
header('Allow: GET, HEAD'); http_response_code(405); exit;
}
$body = json_encode(['service' => 'demo', 'schema_version' => 1],
JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
$etag = '"' . hash('sha256', $body) . '"';
$condition = $_SERVER['HTTP_IF_NONE_MATCH'] ?? '';
$match = $condition === '*';
// 只接受完整的带引号标签列表;格式异常时保守地返回200。
if (!$match && strlen($condition) <= 8192 && preg_match(
'/^(?:W\/)?"[^"\r\n]*"(?:\s*,\s*(?:W\/)?"[^"\r\n]*")*$/D', trim($condition))) {
preg_match_all('/(?:W\/)?"[^"\r\n]*"/', $condition, $tags);
foreach ($tags[0] as $tag) {
if (str_starts_with($tag, 'W/')) $tag = substr($tag, 2);
if ($tag === $etag) { $match = true; break; }
}
}
header('ETag: ' . $etag);
header('Cache-Control: public, max-age=60');
if ($match) { http_response_code(304); exit; }
header('Content-Type: application/json; charset=utf-8');
if ($method === 'GET') echo $body;把代码保存成独立测试端点,首次GET应取得200、正文和ETag;随后携带该ETag发送If-None-Match应取得304且无正文。HEAD采用相同表示和条件判断,但即使未命中也不输出JSON。这里没有手动设置Content-Length,避免与服务器输出转换冲突。

HTTP语义标准中的If-None-Match、弱比较和GET/HEAD的304条件
缓存命中前仍要完成必要授权
对真实业务接口,应先判断请求是否有权看到资源,再计算其表示和条件结果。不要因为客户端知道某个ETag就跳过鉴权,也不要用公共缓存保存个性化内容。本例固定响应总是存在,才允许星号条件直接匹配;资源不存在时不能沿用这个结论。
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。
代理压缩、CDN转换或框架自动生成ETag时,应统一由一层负责表示与校验器,避免对不同编码的字节错误复用强ETag。这里演示HTTP条件缓存流程,不能把它理解为PHP 8.6新引入的功能。


















