压缩只留 1600 档;视频缓存失效加版本号 (#56 #57)

一、尺寸档位(用户:「400压缩的太多了。800也不够,只保留一个1600」)
   media.php 白名单从三档收到一档:
     1600 => image/resize,l_1600/quality,q_88
   400/800 删除。质量从 q_85 提到 q_88(只留一档就该偏清楚那侧)。
   照片墙跟随改 1600,缩略图与大图共用一份缓存。
   传旧 ?w=400 的链接会落到「非法值 ⇒ 原图」分支,不报错、只是不压缩。

二、视频仍显示 HEVC(用户:「他说是H.265,还是不让播呢?」)

   实测服务端 15 个视频**全部 h264**,无一个 HEVC:
     ffprobe 逐个查过,codec=h264,pix_fmt=yuv420p/yuvj420p
     media.php 返回 Content-Type: video/mp4,body 里无 hvc1/hev1
     ETag 与实际内容完全一致

   问题在浏览器缓存:
     Cache-Control: private, max-age=604800(7 天)
     浏览器对 <video> 有自己的媒体缓存策略,不完全遵守 ETag
     Range 分段缓存会把每段当独立资源
     src 不变时直接复用已有媒体对象

   修法:让 URL 变。media_url() 加第三个参数 $ver,
   用附件 size 当版本号 → media.php?k=...&v=2295119

   为什么用 size 而不是 mtime/md5:
     mtime —— 对象在 OSS 上,本地拿不到可靠时间
     md5   —— 要读整个文件,几百 MB 视频不可接受
     size  —— 转码前后必然不同(1.22MB→2.19MB),且本就在库里,零开销

   照片墙已接入。其余调用点可逐步铺开。
This commit is contained in:
2026-11-05 13:11:44 +08:00
parent d6af211a8e
commit 2c44318a51
3 changed files with 55 additions and 11 deletions
+30 -2
View File
@@ -88,7 +88,31 @@ function avatar_url(?string $key): string
* 附件代理地址。
* @param array $extra 额外参数,如 ['dl' => 1] 表示按下附件下载
*/
function media_url(?string $key, array $extra = []): string
/**
* 附件访问地址(走 media.php 代理)。
*
* @param array $extra 额外参数:`w`(压缩档位 1600)、`dl`(下载)等
* @param int $ver 内容版本(通常是附件 size)。
* **变了就让 URL 变**,从而绕过一切缓存。
*
* 🔴 #57(用户:「他说是H.265,还是不让播呢?」):
* 转码后服务端确实是 h264 了(15 个视频全部实测过),但浏览器还在放旧的。
*
* 原因是**媒体缓存**:`Cache-Control: max-age=604800`(7 天),
* 而浏览器对 `<video>` 有自己的一套:
* · 不完全遵守 ETag
* · `Range` 分段缓存会把每段当独立资源
* · `src` 不变时直接复用已有媒体对象
*
* ⇒ 最可靠的做法是**让 URL 变**。URL 一变任何缓存层都不会命中。
*
* ⚠️ 版本号用 `size` 而不是 `mtime`/`md5`:
* · `mtime`:对象在 OSS 上,本地拿不到可靠时间
* · `md5`:要读整个文件,几百 MB 的视频不可接受
* · `size` 够用(转码前后体积必然不同:1.22MB → 2.19MB),
* 而且它本来就在数据库里,零开销。
*/
function media_url(?string $key, array $extra = [], int $ver = 0): string
{
$key = trim((string)$key);
if ($key === '') {
@@ -98,7 +122,11 @@ function media_url(?string $key, array $extra = []): string
if (preg_match('#^https?://#i', $key)) {
return $key;
}
return 'media.php?' . http_build_query(array_merge(['k' => ltrim($key, '/')], $extra));
$q = array_merge(['k' => ltrim($key, '/')], $extra);
if ($ver > 0) {
$q['v'] = $ver;
}
return 'media.php?' . http_build_query($q);
}
// ---------------- 人:怎么称呼、什么颜色 ----------------