138 lines
3.0 KiB
PHP
138 lines
3.0 KiB
PHP
<?php namespace Laravel;
|
|
|
|
class Cookie {
|
|
|
|
/**
|
|
* All of the cookies for the current request.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $cookies;
|
|
|
|
/**
|
|
* The cookies that will be sent to the browser at the end of the request.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $queue = array();
|
|
|
|
/**
|
|
* Create a new cookie manager instance.
|
|
*
|
|
* @param array $cookies
|
|
* @return void
|
|
*/
|
|
public function __construct(&$cookies)
|
|
{
|
|
$this->cookies = &$cookies;
|
|
}
|
|
|
|
/**
|
|
* Determine if a cookie exists.
|
|
*
|
|
* @param string $name
|
|
* @return bool
|
|
*/
|
|
public function has($name)
|
|
{
|
|
return ! is_null($this->get($name));
|
|
}
|
|
|
|
/**
|
|
* Get the value of a cookie.
|
|
*
|
|
* <code>
|
|
* // Get the value of a cookie
|
|
* $value = Cookie::get('color');
|
|
*
|
|
* // Get the value of a cookie or return a default value
|
|
* $value = Cookie::get('color', 'blue');
|
|
* </code>
|
|
*
|
|
* @param string $name
|
|
* @param mixed $default
|
|
* @return string
|
|
*/
|
|
public function get($name, $default = null)
|
|
{
|
|
return Arr::get($this->cookies, $name, $default);
|
|
}
|
|
|
|
/**
|
|
* Set a "permanent" cookie. The cookie will last 5 years.
|
|
*
|
|
* @param string $name
|
|
* @param string $value
|
|
* @param string $path
|
|
* @param string $domain
|
|
* @param bool $secure
|
|
* @param bool $http_only
|
|
* @return bool
|
|
*/
|
|
public function forever($name, $value, $path = '/', $domain = null, $secure = false, $http_only = false)
|
|
{
|
|
return $this->put($name, $value, 2628000, $path, $domain, $secure, $http_only);
|
|
}
|
|
|
|
/**
|
|
* Set the value of a cookie.
|
|
*
|
|
* If a negative number of minutes is specified, the cookie will be deleted.
|
|
*
|
|
* Note: This method's signature is very similar to the PHP setcookie method.
|
|
* However, you simply need to pass the number of minutes for which you
|
|
* wish the cookie to be valid. No funky time calculation is required.
|
|
*
|
|
* <code>
|
|
* // Create a cookie that exists until the user closes their browser
|
|
* Cookie::put('color', 'blue');
|
|
*
|
|
* // Create a cookie that exists for 5 minutes
|
|
* Cookie::put('name', 'blue', 5);
|
|
* </code>
|
|
*
|
|
* @param string $name
|
|
* @param string $value
|
|
* @param int $minutes
|
|
* @param string $path
|
|
* @param string $domain
|
|
* @param bool $secure
|
|
* @param bool $http_only
|
|
* @return bool
|
|
*/
|
|
public function put($name, $value, $minutes = 0, $path = '/', $domain = null, $secure = false, $http_only = false)
|
|
{
|
|
if ($minutes < 0) unset($this->cookies[$name]);
|
|
|
|
$time = ($minutes != 0) ? time() + ($minutes * 60) : 0;
|
|
|
|
$this->queue[] = compact('name', 'value', 'time', 'path', 'domain', 'secure', 'http_only');
|
|
}
|
|
|
|
/**
|
|
* Send all of the cookies in the queue to the browser.
|
|
*
|
|
* This method is called automatically at the end of every request.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function send()
|
|
{
|
|
foreach ($this->queue as $cookie)
|
|
{
|
|
call_user_func_array('setcookie', $cookie);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Delete a cookie.
|
|
*
|
|
* @param string $name
|
|
* @return bool
|
|
*/
|
|
public function forget($name)
|
|
{
|
|
return $this->put($name, null, -60);
|
|
}
|
|
|
|
} |