影像處理流程

最後更新


本頁說明 GET /c/img/*path 從判斷是否需要轉檔、libvips 處理順序到串流回應的完整流程。

分流判斷


GetFromPath 依序判斷,命中即回應並結束:
順序條件行為
1路徑以 .pdf 結尾以 application/pdf 串流原檔
2路徑以 .svg 結尾以 image/svg+xml 串流原檔
3o=1依副檔名推斷 MIME(GetMimeType)並串流原檔
4本地快取檔存在依 t 設定 Content-Type 並串流快取檔
5其他進入 libvips 轉檔

所有分支都先設定 7 天的 Cache-Control 與 Expires。第 1–3 種分支的原檔不存在時回 404,內容為 File not found。

轉檔步驟


轉檔在 goroutine 內執行,受 30 秒逾時限制:
步驟呼叫說明
1os.MkdirAll建立快取檔所在目錄
2os.ReadFile → vips.NewImageFromBuffer讀原檔並解碼
3GetNewSize → Resize(scale, KernelLanczos3)尺寸不同時以 Lanczos3 等比例縮放(規則見 尺寸計算)
4GaussianBlur(GetBlur(b))高斯模糊,sigma 限制於 0–100
5Linear([B], [0])亮度:各通道乘以 B;B 非數字時轉檔失敗
6ExportJpeg/ExportPng/ExportAvif/ExportWebp依 t 匯出;PNG 不套用品質
7os.WriteFile寫入本地快取檔

任一步驟失敗都改回 404 佔位 SVG(d=1 或 d=dark 為深色版),並帶 Cache-Control: no-cache;utils.HandleGetError 以 c.File 輸出,HTTP 狀態碼為 200。

串流輸出


streamImage(記憶體內 buffer)與 streamFile(原檔)皆以 Transfer-Encoding: chunked 輸出,每累積一個 buffer 就 Flush 一次:
檔案大小buffer
≤ 50 KiB2 KiB
≤ 500 KiB4 KiB
≤ 2 MiB8 KiB
其他16 KiB

streamFile 另外送出 Content-Length;ResponseWriter 不支援 http.Flusher 時改用 c.File 一次輸出。
EN