<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Case-insensitive dictionary, suitable for HTTP headers

[2] Fix | Delete

*

[3] Fix | Delete

* @package Requests

[4] Fix | Delete

*/

[5] Fix | Delete

[6] Fix | Delete

namespace WpOrg\Requests\Response;

[7] Fix | Delete

[8] Fix | Delete

use WpOrg\Requests\Exception;

[9] Fix | Delete

use WpOrg\Requests\Exception\InvalidArgument;

[10] Fix | Delete

use WpOrg\Requests\Utility\CaseInsensitiveDictionary;

[11] Fix | Delete

use WpOrg\Requests\Utility\FilteredIterator;

[12] Fix | Delete

[13] Fix | Delete

/**

[14] Fix | Delete

* Case-insensitive dictionary, suitable for HTTP headers

[15] Fix | Delete

*

[16] Fix | Delete

* @package Requests

[17] Fix | Delete

*/

[18] Fix | Delete

class Headers extends CaseInsensitiveDictionary {

[19] Fix | Delete

/**

[20] Fix | Delete

* Get the given header

[21] Fix | Delete

*

[22] Fix | Delete

* Unlike {@see \WpOrg\Requests\Response\Headers::getValues()}, this returns a string. If there are

[23] Fix | Delete

* multiple values, it concatenates them with a comma as per RFC2616.

[24] Fix | Delete

*

[25] Fix | Delete

* Avoid using this where commas may be used unquoted in values, such as

[26] Fix | Delete

* Set-Cookie headers.

[27] Fix | Delete

*

[28] Fix | Delete

* @param string $offset Name of the header to retrieve.

[29] Fix | Delete

* @return string|null Header value

[30] Fix | Delete

*/

[31] Fix | Delete

public function offsetGet($offset) {

[32] Fix | Delete

if (is_string($offset)) {

[33] Fix | Delete

$offset = strtolower($offset);

[34] Fix | Delete

}

[35] Fix | Delete

[36] Fix | Delete

if (!isset($this->data[$offset])) {

[37] Fix | Delete

return null;

[38] Fix | Delete

}

[39] Fix | Delete

[40] Fix | Delete

return $this->flatten($this->data[$offset]);

[41] Fix | Delete

}

[42] Fix | Delete

[43] Fix | Delete

/**

[44] Fix | Delete

* Set the given item

[45] Fix | Delete

*

[46] Fix | Delete

* @param string $offset Item name

[47] Fix | Delete

* @param string $value Item value

[48] Fix | Delete

*

[49] Fix | Delete

* @throws \WpOrg\Requests\Exception On attempting to use dictionary as list (`invalidset`)

[50] Fix | Delete

*/

[51] Fix | Delete

public function offsetSet($offset, $value) {

[52] Fix | Delete

if ($offset === null) {

[53] Fix | Delete

throw new Exception('Object is a dictionary, not a list', 'invalidset');

[54] Fix | Delete

}

[55] Fix | Delete

[56] Fix | Delete

if (is_string($offset)) {

[57] Fix | Delete

$offset = strtolower($offset);

[58] Fix | Delete

}

[59] Fix | Delete

[60] Fix | Delete

if (!isset($this->data[$offset])) {

[61] Fix | Delete

$this->data[$offset] = [];

[62] Fix | Delete

}

[63] Fix | Delete

[64] Fix | Delete

$this->data[$offset][] = $value;

[65] Fix | Delete

}

[66] Fix | Delete

[67] Fix | Delete

/**

[68] Fix | Delete

* Get all values for a given header

[69] Fix | Delete

*

[70] Fix | Delete

* @param string $offset Name of the header to retrieve.

[71] Fix | Delete

* @return array|null Header values

[72] Fix | Delete

*

[73] Fix | Delete

* @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not valid as an array key.

[74] Fix | Delete

*/

[75] Fix | Delete

public function getValues($offset) {

[76] Fix | Delete

if (!is_string($offset) && !is_int($offset)) {

[77] Fix | Delete

throw InvalidArgument::create(1, '$offset', 'string|int', gettype($offset));

[78] Fix | Delete

}

[79] Fix | Delete

[80] Fix | Delete

if (is_string($offset)) {

[81] Fix | Delete

$offset = strtolower($offset);

[82] Fix | Delete

}

[83] Fix | Delete

[84] Fix | Delete

if (!isset($this->data[$offset])) {

[85] Fix | Delete

return null;

[86] Fix | Delete

}

[87] Fix | Delete

[88] Fix | Delete

return $this->data[$offset];

[89] Fix | Delete

}

[90] Fix | Delete

[91] Fix | Delete

/**

[92] Fix | Delete

* Flattens a value into a string

[93] Fix | Delete

*

[94] Fix | Delete

* Converts an array into a string by imploding values with a comma, as per

[95] Fix | Delete

* RFC2616's rules for folding headers.

[96] Fix | Delete

*

[97] Fix | Delete

* @param string|array $value Value to flatten

[98] Fix | Delete

* @return string Flattened value

[99] Fix | Delete

*

[100] Fix | Delete

* @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not a string or an array.

[101] Fix | Delete

*/

[102] Fix | Delete

public function flatten($value) {

[103] Fix | Delete

if (is_string($value)) {

[104] Fix | Delete

return $value;

[105] Fix | Delete

}

[106] Fix | Delete

[107] Fix | Delete

if (is_array($value)) {

[108] Fix | Delete

return implode(',', $value);

[109] Fix | Delete

}

[110] Fix | Delete

[111] Fix | Delete

throw InvalidArgument::create(1, '$value', 'string|array', gettype($value));

[112] Fix | Delete

}

[113] Fix | Delete

[114] Fix | Delete

/**

[115] Fix | Delete

* Get an iterator for the data

[116] Fix | Delete

*

[117] Fix | Delete

* Converts the internally stored values to a comma-separated string if there is more

[118] Fix | Delete

* than one value for a key.

[119] Fix | Delete

*

[120] Fix | Delete

* @return \ArrayIterator

[121] Fix | Delete

*/

[122] Fix | Delete

public function getIterator() {

[123] Fix | Delete

return new FilteredIterator($this->data, [$this, 'flatten']);

[124] Fix | Delete

}

[125] Fix | Delete

}

[126] Fix | Delete

[127] Fix | Delete