Curl::setup_handle( string $url, array $headers, string|array $data, array $options )

366	private function setup_handle($url, $headers, $data, $options) {367		$options['hooks']->dispatch('curl.before_request', [&$this->handle]);368 369		// Force closing the connection for old versions of cURL (<7.22).370		if (!isset($headers['Connection'])) {371			$headers['Connection'] = 'close';372		}373 374		/**375		 * Add "Expect" header.376		 *377		 * By default, cURL adds a "Expect: 100-Continue" to most requests. This header can378		 * add as much as a second to the time it takes for cURL to perform a request. To379		 * prevent this, we need to set an empty "Expect" header. To match the behaviour of380		 * Guzzle, we'll add the empty header to requests that are smaller than 1 MB and use381		 * HTTP/1.1.382		 *383		 * https://curl.se/mail/lib-2017-07/0013.html384		 */385		if (!isset($headers['Expect']) && $options['protocol_version'] === 1.1) {386			$headers['Expect'] = $this->get_expect_header($data);387		}388 389		$headers = Requests::flatten($headers);390 391		if (!empty($data)) {392			$data_format = $options['data_format'];393 394			if ($data_format === 'query') {395				$url  = self::format_get($url, $data);396				$data = '';397			} elseif (!is_string($data)) {398				$data = http_build_query($data, '', '&');399			}400		}401 402		switch ($options['type']) {403			case Requests::POST:404				curl_setopt($this->handle, CURLOPT_POST, true);405				curl_setopt($this->handle, CURLOPT_POSTFIELDS, $data);406				break;407			case Requests::HEAD:408				curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']);409				curl_setopt($this->handle, CURLOPT_NOBODY, true);410				break;411			case Requests::TRACE:412				curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']);413				break;414			case Requests::PATCH:415			case Requests::PUT:416			case Requests::DELETE:417			case Requests::OPTIONS:418			default:419				curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']);420				if (!empty($data)) {421					curl_setopt($this->handle, CURLOPT_POSTFIELDS, $data);422				}423		}424 425		// cURL requires a minimum timeout of 1 second when using the system426		// DNS resolver, as it uses `alarm()`, which is second resolution only.427		// There's no way to detect which DNS resolver is being used from our428		// end, so we need to round up regardless of the supplied timeout.429		//430		// https://github.com/curl/curl/blob/4f45240bc84a9aa648c8f7243be7b79e9f9323a5/lib/hostip.c#L606-L609431		$timeout = max($options['timeout'], 1);432 433		if (is_int($timeout) || $this->version < self::CURL_7_16_2) {434			curl_setopt($this->handle, CURLOPT_TIMEOUT, ceil($timeout));435		} else {436			// phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_timeout_msFound437			curl_setopt($this->handle, CURLOPT_TIMEOUT_MS, round($timeout * 1000));438		}439 440		if (is_int($options['connect_timeout']) || $this->version < self::CURL_7_16_2) {441			curl_setopt($this->handle, CURLOPT_CONNECTTIMEOUT, ceil($options['connect_timeout']));442		} else {443			// phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_connecttimeout_msFound444			curl_setopt($this->handle, CURLOPT_CONNECTTIMEOUT_MS, round($options['connect_timeout'] * 1000));445		}