## 請求緩存
支持請求緩存功能,支持對GET請求設置緩存訪問,并設置有效期。
> 請求緩存僅對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`秒的請求緩存。
> 如果`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',
],
~~~
排除規則為不使用請求緩存的地址(不支持變量)開頭部分(不區分大小寫)。
> 路由中設置的請求緩存依然有效并且優先,如果需要設置特殊的請求緩存有效期就可以直接在路由中設置。