请求缓存

最后更新于:2022-04-02 01:49:44

## 请求缓存 支持请求缓存功能,支持对GET请求设置缓存访问,并设置有效期。 >[danger] 请求缓存仅对GET请求有效 有两种方式可以设置请求缓存: ### 路由设置 可以在路由规则里面调用`cache`方法设置当前路由规则的请求缓存,例如: ~~~ // 定义GET请求路由规则 并设置3600秒的缓存 Route::get('new/:id','News/read')->cache(3600); ~~~ 第二次访问相同的路由地址的时候,会自动获取请求缓存的数据响应输出,并发送`304`状态码。 默认请求缓存的标识为当前访问的`pathinfo`地址,可以定义请求缓存的标识,如下: ~~~ // 定义GET请求路由规则 并设置3600秒的缓存 Route::get('new/:id','News/read')->cache( [ 'new/:id/:page', 3600 ] ); ~~~ `:id`、`:page`表示使用当前请求的`param`参数进行动态标识替换,也就是根据`id`和`page`变量进行`3600`秒的请求缓存。 >[danger] 如果`cache`参数传入`false`,则表示关闭当前路由的请求缓存(即使开启全局请求缓存)。 支持给一组路由设置缓存标签 ~~~ // 定义GET请求路由规则 并设置3600秒的缓存 Route::get('new/:id','News/read')->cache( [ 'new/:id/:page', 3600, 'page' ] ); ~~~ 这样可以在需要的时候统一清理缓存标签为`page`的请求缓存。 ### 动态设置 可以在公共文件或者行为中动态设置请求缓存,例如: ~~~ Request::cache('blog/:id',3600); ~~~ 表示对`blog/:id`定义的动态访问地址进行`3600`秒的请求缓存。 > 变量支持当前的请求变量(也就是`param`方法的所有变量)。 可以使用当前的URL地址作为缓存标识,如下: ~~~ Request::cache('__URL__',600); ~~~ 支持对某个URL后缀的请求进行缓存,例如: ~~~ Request::cache('[html]',600); ~~~ 表示对所有的`html`后缀访问(GET)请求进行10分钟的缓存。 也支持设置请求缓存标签,例如: ~~~ Request::cache('blog/:id/:page',3600, 'page'); ~~~ ## 自动缓存 可以通过开启自动缓存和全局缓存有效期设置请求缓存,支持在模块配置中单独设置开启请求缓存。 只需要在配置文件中开启: ~~~ 'request_cache' => true, 'request_cache_expire' => 3600, ~~~ 就会自动根据当前请求URL地址(只针对GET请求类型)进行请求缓存,全局缓存有效期为3600秒。 如果需要对全局缓存设置缓存规则,可以直接设置`request_cache`参数为字符串,例如下面的方式: ~~~ 'request_cache' => '__URL__', 'request_cache_expire' => 3600, ~~~ 缓存标识支持下面的特殊定义 |标识|含义| |---|---| |`__MODULE__`|当前模块名| |`__CONTROLLER__`|当前控制器名| |`__ACTION__`|当前操作名| |`__URL__`|当前完整URL地址(包含域名)| 全局请求缓存支持设置排除规则,使用方法如下: ~~~ 'request_cache' => true, 'request_cache_expire' => 3600, 'request_cache_except' => [ '/blog/index', '/user/member', ], ~~~ 排除规则为不使用请求缓存的地址(不支持变量)开头部分(不区分大小写)。 >[info] 路由中设置的请求缓存依然有效并且优先,如果需要设置特殊的请求缓存有效期就可以直接在路由中设置。
';