/**
* Handles dates as defined by RFC 2616 section 3.3.1, and also some other
* non-standard, but common formats.
- *
- * @var array
*/
private static $dateFormats = array(
'D, d M Y H:i:s T',
/**
* Sets a cookie.
*
- * @param string $name The cookie name
- * @param string $value The value of the cookie
- * @param string $expires The time the cookie expires
- * @param string $path The path on the server in which the cookie will be available on
- * @param string $domain The domain that the cookie is available
- * @param bool $secure Indicates that the cookie should only be transmitted over a secure HTTPS connection from the client
- * @param bool $httponly The cookie httponly flag
- * @param bool $encodedValue Whether the value is encoded or not
+ * @param string $name The cookie name
+ * @param string $value The value of the cookie
+ * @param string|null $expires The time the cookie expires
+ * @param string|null $path The path on the server in which the cookie will be available on
+ * @param string $domain The domain that the cookie is available
+ * @param bool $secure Indicates that the cookie should only be transmitted over a secure HTTPS connection from the client
+ * @param bool $httponly The cookie httponly flag
+ * @param bool $encodedValue Whether the value is encoded or not
*/
public function __construct($name, $value, $expires = null, $path = null, $domain = '', $secure = false, $httponly = true, $encodedValue = false)
{
$this->rawValue = $value;
} else {
$this->value = $value;
- $this->rawValue = urlencode($value);
+ $this->rawValue = rawurlencode($value);
}
$this->name = $name;
$this->path = empty($path) ? '/' : $path;
/**
* Returns the HTTP representation of the Cookie.
- *
- * @return string The HTTP representation of the Cookie
- *
- * @throws \UnexpectedValueException
*/
public function __toString()
{
/**
* Creates a Cookie instance from a Set-Cookie header value.
*
- * @param string $cookie A Set-Cookie header value
- * @param string $url The base URL
+ * @param string $cookie A Set-Cookie header value
+ * @param string|null $url The base URL
*
* @return static
*
continue;
}
- if (2 === count($elements = explode('=', $part, 2))) {
+ if (2 === \count($elements = explode('=', $part, 2))) {
if ('expires' === strtolower($elements[0])) {
$elements[1] = self::parseDate($elements[1]);
}
private static function parseDate($dateValue)
{
// trim single quotes around date if present
- if (($length = strlen($dateValue)) > 1 && "'" === $dateValue[0] && "'" === $dateValue[$length - 1]) {
+ if (($length = \strlen($dateValue)) > 1 && "'" === $dateValue[0] && "'" === $dateValue[$length - 1]) {
$dateValue = substr($dateValue, 1, -1);
}
/**
* Gets the expires time of the cookie.
*
- * @return string The cookie expires time
+ * @return string|null The cookie expires time
*/
public function getExpiresTime()
{