PHP动态输出图片隐藏路径时subresource浏览器缓存失效问题咨询
你碰到的预加载失效、动态图片缓存不生效的问题,根本不是PHP动态出图的场景本身不支持缓存,两个容易踩的低级bug占了90%的原因:
1. 代码写漏的变量解析问题
你现在输出subresource标签用了PHP单引号字符串包裹,PHP单引号是不会解析内部的任何变量的,所有内容都会当做纯文本原样输出。
最后浏览器实际拿到的link标签,href值是字面上的imageConvert.php?raw=$image&cap=ps&hash=$user_id,和img标签src里被正确解析了变量的动态接口地址完全对不上。浏览器根本识别不到这是同一个资源的预加载声明,预加载流程从代码输出阶段就已经失效了,跟动态地址本身没关系。
2. 动态接口没带浏览器要的缓存头
之前用静态图片的时候,Web服务器会自动给静态资源附带Cache-Control、ETag这类缓存校验规则,浏览器默认知道这些静态图是可以存在本地的。换成PHP动态输出图片之后,这些响应头不会自动生成,浏览器默认会把PHP输出的内容判定成“随时可能变的动态内容”,就算你预加载拉了一次图片,后续img标签加载的时候还是会重新发请求,根本用不上本地缓存。
之前用静态路径的时候预加载能生效,本质是静态地址本身没有需要解析的变量,两边写的href本来就是一致的,加上服务器自动带缓存头,所以整个缓存流程能跑通,换成动态地址之后,两个bug同时触发,才会出现完全失效的情况。
第一步:统一请求地址,修复代码解析问题
先把img和预加载标签的请求地址抽成同一个变量,彻底避免两边地址不一致的问题,示例代码:
// 统一拼接当前图片的完整请求地址,避免两边手动写地址出现偏差 $imageRequestUrl = "imageConvert.php?raw={$image}&cap=ps&hash={$user_id}"; echo "<img class='lazy' src='{$imageRequestUrl}' />"; // 输出预加载标签,href和img的src完全一致 echo "<link rel=\"subresource\" href=\"{$imageRequestUrl}\" as=\"image\">";
第二步:给imageConvert.php接口配置正确的缓存规则
在接口输出图片流之前,补充符合要求的HTTP缓存响应头,让浏览器愿意把图片存在本地,示例代码:
// 基于当前请求的图片ID、用户ID生成唯一的资源标识,用来做协商缓存校验 $resourceEtag = md5(sprintf("%s_%s", $image, $user_id)); // 配置缓存规则:图片只要权限校验通过、内容不变,就可以让浏览器缓存1年 // 如果你的图片是私有权限访问,把public改成private即可,避免中间代理缓存 header("Cache-Control: public, max-age=31536000, immutable"); header("ETag: \"{$resourceEtag}\""); // 匹配浏览器的协商缓存请求,如果本地缓存的ETag和服务端计算的一致,直接返回304不重复传图 if ( isset($_SERVER['HTTP_IF_NONE_MATCH']) && trim($_SERVER['HTTP_IF_NONE_MATCH']) === "\"{$resourceEtag}\"" ) { http_response_code(304); exit; } // 后续再正常输出JPEG图片的内容和流 header("Content-Type: image/jpeg"); // ... 原有图片输出逻辑不变
可选优化:替换兼容性更好的预加载方案
原本的rel="subresource"是早期的实验性预加载方案,目前主流浏览器已经逐步降低对它的支持优先级,换成通用的rel="preload"可以实现完全一样的效果,兼容性更好,只需要把预加载标签改成:
echo "<link rel=\"preload\" href=\"{$imageRequestUrl}\" as=\"image\">";
因为你的img标签带了lazy类的懒加载属性,只需要给首屏需要立即展示的图片加预加载声明即可,滚动到可视区才加载的非首屏图片,不需要提前预加载,反而会浪费带宽拖慢首屏加载速度。
内容的提问来源于stack exchange,提问作者insaneray

