123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227 |
- <?php
- /*
- * This file is part of the Symfony package.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
- namespace Symfony\Component\HttpFoundation;
- /**
- * Represents an Accept-* header item.
- *
- * @author Jean-François Simon <contact@jfsimon.fr>
- */
- class AcceptHeaderItem
- {
- /**
- * @var string
- */
- private $value;
- /**
- * @var float
- */
- private $quality = 1.0;
- /**
- * @var int
- */
- private $index = 0;
- /**
- * @var array
- */
- private $attributes = array();
- /**
- * Constructor.
- *
- * @param string $value
- * @param array $attributes
- */
- public function __construct($value, array $attributes = array())
- {
- $this->value = $value;
- foreach ($attributes as $name => $value) {
- $this->setAttribute($name, $value);
- }
- }
- /**
- * Builds an AcceptHeaderInstance instance from a string.
- *
- * @param string $itemValue
- *
- * @return AcceptHeaderItem
- */
- public static function fromString($itemValue)
- {
- $bits = preg_split('/\s*(?:;*("[^"]+");*|;*(\'[^\']+\');*|;+)\s*/', $itemValue, 0, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE);
- $value = array_shift($bits);
- $attributes = array();
- $lastNullAttribute = null;
- foreach ($bits as $bit) {
- if (($start = substr($bit, 0, 1)) === ($end = substr($bit, -1)) && ($start === '"' || $start === '\'')) {
- $attributes[$lastNullAttribute] = substr($bit, 1, -1);
- } elseif ('=' === $end) {
- $lastNullAttribute = $bit = substr($bit, 0, -1);
- $attributes[$bit] = null;
- } else {
- $parts = explode('=', $bit);
- $attributes[$parts[0]] = isset($parts[1]) && strlen($parts[1]) > 0 ? $parts[1] : '';
- }
- }
- return new self(($start = substr($value, 0, 1)) === ($end = substr($value, -1)) && ($start === '"' || $start === '\'') ? substr($value, 1, -1) : $value, $attributes);
- }
- /**
- * Returns header value's string representation.
- *
- * @return string
- */
- public function __toString()
- {
- $string = $this->value.($this->quality < 1 ? ';q='.$this->quality : '');
- if (count($this->attributes) > 0) {
- $string .= ';'.implode(';', array_map(function ($name, $value) {
- return sprintf(preg_match('/[,;=]/', $value) ? '%s="%s"' : '%s=%s', $name, $value);
- }, array_keys($this->attributes), $this->attributes));
- }
- return $string;
- }
- /**
- * Set the item value.
- *
- * @param string $value
- *
- * @return AcceptHeaderItem
- */
- public function setValue($value)
- {
- $this->value = $value;
- return $this;
- }
- /**
- * Returns the item value.
- *
- * @return string
- */
- public function getValue()
- {
- return $this->value;
- }
- /**
- * Set the item quality.
- *
- * @param float $quality
- *
- * @return AcceptHeaderItem
- */
- public function setQuality($quality)
- {
- $this->quality = $quality;
- return $this;
- }
- /**
- * Returns the item quality.
- *
- * @return float
- */
- public function getQuality()
- {
- return $this->quality;
- }
- /**
- * Set the item index.
- *
- * @param int $index
- *
- * @return AcceptHeaderItem
- */
- public function setIndex($index)
- {
- $this->index = $index;
- return $this;
- }
- /**
- * Returns the item index.
- *
- * @return int
- */
- public function getIndex()
- {
- return $this->index;
- }
- /**
- * Tests if an attribute exists.
- *
- * @param string $name
- *
- * @return bool
- */
- public function hasAttribute($name)
- {
- return isset($this->attributes[$name]);
- }
- /**
- * Returns an attribute by its name.
- *
- * @param string $name
- * @param mixed $default
- *
- * @return mixed
- */
- public function getAttribute($name, $default = null)
- {
- return isset($this->attributes[$name]) ? $this->attributes[$name] : $default;
- }
- /**
- * Returns all attributes.
- *
- * @return array
- */
- public function getAttributes()
- {
- return $this->attributes;
- }
- /**
- * Set an attribute.
- *
- * @param string $name
- * @param string $value
- *
- * @return AcceptHeaderItem
- */
- public function setAttribute($name, $value)
- {
- if ('q' === $name) {
- $this->quality = (float) $value;
- } else {
- $this->attributes[$name] = (string) $value;
- }
- return $this;
- }
- }
|