Cookie · tp5文檔

# Cookie ThinkPHP使用`think\Cookie`類提供Cookie支持。 ## 初始化大多數情況下，我們不需要進行`Cookie`的初始化，系統會在調用`Cooie`類方法的時候自動根據`cache`配置參數初始化，如果需要可以手動使用`init`方法進行初始化設置，例如： ``` <pre class="calibre18"> ``` // cookie初始化 Cookie::init(['prefix'=>'think_', 'expire'=>3600, 'path'=>'/']); // 單獨指定當前前綴 Cookie::prefix('think_'); ``` ``` 支持的參數及默認值如下： ``` <pre class="calibre18"> ``` // cookie 名稱前綴'prefix' => '', // cookie 保存時間'expire' => 0, // cookie 保存路徑'path' => '/', // cookie 有效域名'domain' => '', // cookie 啟用安全傳輸'secure' => false, // httponly設置'httponly' => '', // 是否使用 setcookie'setcookie' => true, ``` ``` ## 讀取Cookie 建議的讀取`Cookie`數據的方法是通過`Request`請求對象的`cookie`方法（原因和Session讀取一樣），例如： ``` <pre class="calibre18"> ``` namespace app\index\controller; use think\Request; class User{ public function index(Request $request){ echo $request->cookie('user_name'); // 讀取二維數組echo $request->cookie('user.name'); } } ``` ``` > 通過Request對象讀取Cookie數據支持默認值及過濾方法，因此也更加安全，并且支持多維數組的讀取。當然也支持使用`Cookie`類直接讀取數據： ``` <pre class="calibre18"> ``` namespace app\index\controller; use think\Cookie; class User{ public function index(){ echo Cookie::get('user_name'); } } ``` ``` > Cookie::get方法不支持讀取二維數組數據。 ## 模板輸出同樣，可以使用下面的方法在模板文件中輸出Cookie值。 ``` <pre class="calibre18"> ``` {$Request.cookie.user_name} ``` ``` ## `Cookie`操作下面是一些關于Cookie的基礎操作方法。 ### 設置 ``` <pre class="calibre18"> ``` // 設置Cookie 有效期為 3600秒 Cookie::set('name','value',3600); // 設置cookie 前綴為think_ Cookie::set('name','value',['prefix'=>'think_', 'expire'=>3600]); // 支持數組 Cookie::set('name',[1,2,3]); ``` ``` ### 判斷 ``` <pre class="calibre18"> ``` Cookie::has('name'); // 判斷指定前綴的cookie值是否存在Cookie::has('name','think_'); ``` ``` ### 獲取 ``` <pre class="calibre18"> ``` Cookie::get('name'); // 獲取指定前綴的cookie值Cookie::get('name','think_'); ``` ``` ### 刪除 //刪除cookie ``` <pre class="calibre18"> ``` Cookie::delete('name'); // 刪除指定前綴的cookieCookie::delete('name','think_'); ``` ``` ### 清空 ``` <pre class="calibre18"> ``` // 清空指定前綴的cookieCookie::clear('think_'); ``` ``` > 注意，目前不支持清空所有的`Cookie`數據，如果必須這樣做，請直接操作`$_COOKIE`變量。 ## 助手函數系統提供了`cookie`助手函數用于基本的`Cookie`操作，可以完成前面的所有功能，例如： ``` <pre class="calibre42"> ``` // 初始化 cookie(['prefix' => 'think_', 'expire' => 3600]); // 設置 cookie('name', 'value', 3600); // 判斷 cookie('?name'); // 獲取echo cookie('name'); // 刪除 cookie('name', null); // 清除 cookie(null, 'think_'); ``` ```