Jar

26class Jar implements ArrayAccess, IteratorAggregate {27	/**28	 * Actual item data29	 *30	 * @var array31	 */32	protected $cookies = [];33 34	/**35	 * Create a new jar36	 *37	 * @param array $cookies Existing cookie values38	 *39	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not an array.40	 */41	public function __construct($cookies = []) {42		if (is_array($cookies) === false) {43			throw InvalidArgument::create(1, '$cookies', 'array', gettype($cookies));44		}45 46		$this->cookies = $cookies;47	}48 49	/**50	 * Normalise cookie data into a \WpOrg\Requests\Cookie51	 *52	 * @param string|\WpOrg\Requests\Cookie $cookie Cookie header value, possibly pre-parsed (object).53	 * @param string                        $key    Optional. The name for this cookie.54	 * @return \WpOrg\Requests\Cookie55	 */56	public function normalize_cookie($cookie, $key = '') {57		if ($cookie instanceof Cookie) {58			return $cookie;59		}60 61		return Cookie::parse($cookie, $key);62	}63 64	/**65	 * Check if the given item exists66	 *67	 * @param string $offset Item key68	 * @return boolean Does the item exist?69	 */70	#[ReturnTypeWillChange]71	public function offsetExists($offset) {72		return isset($this->cookies[$offset]);73	}74 75	/**76	 * Get the value for the item77	 *78	 * @param string $offset Item key79	 * @return string|null Item value (null if offsetExists is false)80	 */81	#[ReturnTypeWillChange]82	public function offsetGet($offset) {83		if (!isset($this->cookies[$offset])) {84			return null;85		}86 87		return $this->cookies[$offset];88	}89 90	/**91	 * Set the given item92	 *93	 * @param string $offset Item name94	 * @param string $value Item value95	 *96	 * @throws \WpOrg\Requests\Exception On attempting to use dictionary as list (`invalidset`)97	 */98	#[ReturnTypeWillChange]99	public function offsetSet($offset, $value) {100		if ($offset === null) {101			throw new Exception('Object is a dictionary, not a list', 'invalidset');102		}103 104		$this->cookies[$offset] = $value;105	}