Fsockopen

25final class Fsockopen implements Transport {26	/**27	 * Second to microsecond conversion28	 *29	 * @var integer30	 */31	const SECOND_IN_MICROSECONDS = 1000000;32 33	/**34	 * Raw HTTP data35	 *36	 * @var string37	 */38	public $headers = '';39 40	/**41	 * Stream metadata42	 *43	 * @var array Associative array of properties, see {@link https://www.php.net/stream_get_meta_data}44	 */45	public $info;46 47	/**48	 * What's the maximum number of bytes we should keep?49	 *50	 * @var int|bool Byte count, or false if no limit.51	 */52	private $max_bytes = false;53 54	/**55	 * Cache for received connection errors.56	 *57	 * @var string58	 */59	private $connect_error = '';60 61	/**62	 * Perform a request63	 *64	 * @param string|Stringable $url URL to request65	 * @param array $headers Associative array of request headers66	 * @param string|array $data Data to send either as the POST body, or as parameters in the URL for a GET/HEAD67	 * @param array $options Request options, see {@see \WpOrg\Requests\Requests::response()} for documentation68	 * @return string Raw HTTP result69	 *70	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string or Stringable.71	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $headers argument is not an array.72	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $data parameter is not an array or string.73	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array.74	 * @throws \WpOrg\Requests\Exception       On failure to connect to socket (`fsockopenerror`)75	 * @throws \WpOrg\Requests\Exception       On socket timeout (`timeout`)76	 */77	public function request($url, $headers = [], $data = [], $options = []) {78		if (InputValidator::is_string_or_stringable($url) === false) {79			throw InvalidArgument::create(1, '$url', 'string|Stringable', gettype($url));80		}81 82		if (is_array($headers) === false) {83			throw InvalidArgument::create(2, '$headers', 'array', gettype($headers));84		}85 86		if (!is_array($data) && !is_string($data)) {87			if ($data === null) {88				$data = '';89			} else {90				throw InvalidArgument::create(3, '$data', 'array|string', gettype($data));91			}92		}93 94		if (is_array($options) === false) {95			throw InvalidArgument::create(4, '$options', 'array', gettype($options));96		}97 98		$options['hooks']->dispatch('fsockopen.before_request');99 100		$url_parts = parse_url($url);101		if (empty($url_parts)) {102			throw new Exception('Invalid URL.', 'invalidurl', $url);103		}104