浏览器缓存控制插件

cache-control插件实现了基于 URL 文件后缀来为请求的响应头部添加 Expires 和 Cache-Control 头部,从而方便浏览器对特定后缀的文件进行缓存,例如 jpgpng 等图片文件。

运行属性

插件执行阶段:认证阶段 插件执行优先级:420

配置字段

名称

数据类型

填写要求

默认值

描述

suffix

string

选填,表示匹配的文件后缀名,例如 jpgpng 等。

如果需要匹配多种后缀,需要用 | 进行分割,例如 png|jpg

如果不填写,表示匹配所有后缀

-

配置用于匹配的请求文件后缀

expires

string

必填,表示缓存的最长时间。

当填入的字符串为数字时,单位为秒,例如需要缓存1小时,需填写 3600。

另外,还可以填写 epoch 或 max

,与 nginx 中语义相同。

-

配置缓存的最大时间

配置示例

  1. 缓存后缀为 jpgpngjpeg 的文件,缓存时间为一小时。

    suffix: jpg|png|jpeg
    expires: 3600

    根据该配置,下列请求在访问时,将会在响应头中添加 Expires 和 Cache-Control 字段,且过期时间为 1 小时后。

    curl http://example.com/test.png
    curl http://exmaple.com/test.jpg
  2. 缓存所有文件,且缓存至最大时间 “Thu, 31 Dec 2037 23:55:55 GMT”

    expires: max