Laravel框架中Cookie的添加、获取和清除方法
最近在Laravel框架中使用Cookie的时候,碰到了许多问题,期间研究了Cookie的实现类,也在网站找了许多的资料,包括问答。发现并没有解决问题。网上的答案都是互相抄袭,互相转载。其实并没有什么用处。好在最后,我们找到了决绝方法。奔着为广大Laravel爱好者和开发人员负责的精神,同时也希望大家在使用Cookie时少走弯路,在这里把在Laravel中Cookie的设置和读取方法贡献出来,供大家批评指正。
概述
Cookie的添加其实很简单,直接使用Cookie::make()
,在使用方法前,需要引入Cookie的门面use Illuminate\Support\Facades\Cookie;
,这样就可以完成Cookie的设置了。
不过,设置后我们如何才能取到Cookie值呢?有搜索过相关问题的开发人员肯定知道,网上的答案千篇一律都是:Cookie::get()
,有的甚至附上了代码:
Cookie::make('test', 'hello, world', 10);echo Cookie::get('test');
如果你按照这种类似的回答来测试Cookie,肯定会发现设置cookie的值永远都是null。多次测试无效下,你都会怀疑自己的Laravel框架是不是有问题!
其实,在Laravel框架中使用Cookie,就不得不提到Response和Request。经常用浏览器调试程序的开发者可能会留意过,在请求地址的Response Headers
和Request Headers
中,都包含有cookie信息。没错,如果你在Laravel框架中使用Cookie都离不开Response和Request,下面我们就来介绍Cookie的正确添加和获取方法。
添加Cookie
例如,我们需要在控制器中设置一个"Hello, Laramist"的cookie值,并设置有效期为10分钟。这里推荐使用cookie的队列方法Cookie::queue()
,因为这样Cookie会自动添加到响应:
<?phpnamespace App\Http\Controllers;use Cookie;use App\Http\Controllers\Controller;class DashboardController extends Controller{ /** * Show the application index. * * @return Response */ public function index() { Cookie::queue('test', 'Hello, Laramist', 10); return view('index'); }}
看看Response Headers中是不是多了一条set-cookie
记录。当然,如果你使用的是Response,可以直接使用Response中的withCookie()
方法,将cookie添加到响应中:
public function index(){ $cookie = Cookie::make('test', 'Hello, Laramist', 10); return response()->view('index')->withCookie($cookie);}
要设置一个永不过期的的cookie值,可以使用Cookie::forever()
方法:
Cookie::forever('test', 'Hello, Laramist');
Cookie自身并不提供该方法,由于Cookie的门面由\Illuminate\Cookie\CookieJar
提供,所以Cookie可以使用该类中的方法。这里附上queue()
方法的源码:
/** * Queue a cookie to send with the next response. * * @param mixed * @return void */public function queue(){ if (head(func_get_args()) instanceof Cookie) { $cookie = head(func_get_args()); } else { $cookie = call_user_func_array([$this, 'make'], func_get_args()); } $this->queued[$cookie->getName()] = $cookie;}
从源码可以得知,queue()
方法实际上也是调用的make()
方法。
注意:有些水友提出在返回的视图上注入cookie的方法
return view('index')->withCookie($cookie)
,亲测无效。推荐使用queue()
获取Cookie
在概述里我们提到过,Cookie的使用离不开Response和Request。获取Cookie的值有两个层面,一个是服务端,另一个是客户端。如果要服务端获取到Cookie的值,就需要从Request中获得:
public function index(Request $request){ $cookie = $request->cookie('test'); dump($cookie);}
如果想获得所有Cookie的值,可以使用不传参数的方法:
public function index(Request $request){ $cookies = $request->cookie(); dump($cookies);}
再次访问地址,我们会得到一个所有cookie值的数组,包括我们刚刚设置的test:
array:3 [▼ "XSRF-TOKEN" => "xHYt7DeHIImprvXUDHl0AxPNNsVxLYYCTixDD5FJ" "laravel_session" => "870a7746af78ef0b9f357edc65a3eb94d9492332" "test" => "Hello, Laramist"]
当我们需要在客户端使用的时候,获取Cookie的值就不是这样了。首先,我们通过响应withCookie($cookie)
传输到客户端的数据并不是一个字符串,而是一个cookie对象:
Cookie {#1490 ▼ #name: "test" #value: "Hello, Laramist" #domain: null #expire: 1478245163 #path: "/" #secure: false #httpOnly: true}
获取value值,Cookie类提供了一个getValue()
的方法来拿取。例如在模板中编辑代码:
<p>{{ $cookie->getValue() }}</p>
再次刷新页面时,就会得到设置的test的cookie值:
Hello, Laramist
清除Cookie
清除Cookie的方法比较简单,原理和设置Cookie一样的,只是将过期时间设置成了过去。这里也需要将Cookie加入到HTTP的Response中,使用make()
或者forget()
方法均可:
$cookie = Cookie::forget('test');return Redirect::route('index')->withCookie($cookie);