<?php /** * @see https://github.com/zendframework/zend-http for the canonical source repository * @copyright Copyright (c) 2005-2017 Zend Technologies USA Inc. (http://www.zend.com) * @license https://github.com/zendframework/zend-http/blob/master/LICENSE.md New BSD License */ namespace Zend\Http\Header; /** * Connection Header * * @link http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.10 */ class Connection implements HeaderInterface { const CONNECTION_CLOSE = 'close'; const CONNECTION_KEEP_ALIVE = 'keep-alive'; /** * Value of this header * * @var string */ protected $value = self::CONNECTION_KEEP_ALIVE; /** * @param string $headerLine * @return Connection * @throws Exception\InvalidArgumentException */ public static function fromString($headerLine) { $header = new static(); list($name, $value) = GenericHeader::splitHeaderLine($headerLine); // check to ensure proper header type for this factory if (strtolower($name) !== 'connection') { throw new Exception\InvalidArgumentException('Invalid header line for Connection string: "' . $name . '"'); } $header->setValue(trim($value)); return $header; } /** * Set Connection header to define persistent connection * * @param bool $flag * @return Connection */ public function setPersistent($flag) { $this->value = (bool) $flag ? self::CONNECTION_KEEP_ALIVE : self::CONNECTION_CLOSE; return $this; } /** * Get whether this connection is persistent * * @return bool */ public function isPersistent() { return ($this->value === self::CONNECTION_KEEP_ALIVE); } /** * Set arbitrary header value * RFC allows any token as value, 'close' and 'keep-alive' are commonly used * * @param string $value * @return Connection */ public function setValue($value) { HeaderValue::assertValid($value); $this->value = strtolower($value); return $this; } /** * Connection header name * * @return string */ public function getFieldName() { return 'Connection'; } /** * Connection header value * * @return string */ public function getFieldValue() { return $this->value; } /** * Return header line * * @return string */ public function toString() { return 'Connection: ' . $this->getFieldValue(); } }