Session

26class Session {27	/**28	 * Base URL for requests29	 *30	 * URLs will be made absolute using this as the base31	 *32	 * @var string|null33	 */34	public $url = null;35 36	/**37	 * Base headers for requests38	 *39	 * @var array40	 */41	public $headers = [];42 43	/**44	 * Base data for requests45	 *46	 * If both the base data and the per-request data are arrays, the data will47	 * be merged before sending the request.48	 *49	 * @var array50	 */51	public $data = [];52 53	/**54	 * Base options for requests55	 *56	 * The base options are merged with the per-request data for each request.57	 * The only default option is a shared cookie jar between requests.58	 *59	 * Values here can also be set directly via properties on the Session60	 * object, e.g. `$session->useragent = 'X';`61	 *62	 * @var array63	 */64	public $options = [];65 66	/**67	 * Create a new session68	 *69	 * @param string|Stringable|null $url Base URL for requests70	 * @param array $headers Default headers for requests71	 * @param array $data Default data for requests72	 * @param array $options Default options for requests73	 *74	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string, Stringable or null.75	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $headers argument is not an array.76	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $data argument is not an array.77	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array.78	 */79	public function __construct($url = null, $headers = [], $data = [], $options = []) {80		if ($url !== null && InputValidator::is_string_or_stringable($url) === false) {81			throw InvalidArgument::create(1, '$url', 'string|Stringable|null', gettype($url));82		}83 84		if (is_array($headers) === false) {85			throw InvalidArgument::create(2, '$headers', 'array', gettype($headers));86		}87 88		if (is_array($data) === false) {89			throw InvalidArgument::create(3, '$data', 'array', gettype($data));90		}91 92		if (is_array($options) === false) {93			throw InvalidArgument::create(4, '$options', 'array', gettype($options));94		}95 96		$this->url     = $url;97		$this->headers = $headers;98		$this->data    = $data;99		$this->options = $options;100 101		if (empty($this->options['cookies'])) {102			$this->options['cookies'] = new Jar();103		}104	}105