class HttpClientCurlDelegate in Http Client 7.2

A delegate for the HttpClient that uses curl to fetch data.

Hierarchy

• class \HttpClientDelegate
  • class \HttpClientCurlDelegate

File

includes/HttpClientCurlDelegate.inc, line 6

class HttpClientCurlDelegate extends HttpClientDelegate {

  /**
   * Executes a request for the HttpClient.
   *
   * @param HttpClient $client
   *  The client we're acting as a delegate for.
   * @param HttpClientRequest $request
   *  The request to execute.
   * @return object
   *  The interpreted response.
   */
  function execute(HttpClient $client, HttpClientRequest $request) {
    $curlopts = array();
    if (isset($client->options['curlopts'])) {
      $curlopts = $curlopts + $client->options['curlopts'];
    }
    if (isset($request->options['curlopts'])) {
      $curlopts = $request->options['curlopts'] + $curlopts;
    }
    $ch = $this
      ->curl($request, $curlopts);
    $response = curl_exec($ch);
    $error = curl_error($ch);
    curl_close($ch);
    if ($error) {
      throw new HttpClientException('Curl Error: ' . $error);
    }
    return $this
      ->interpretResponse($client, $response);
  }

  /**
   * Gets a curl handle for the given request.
   */
  public function curl(HttpClientRequest $request, $curlopts) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_USERAGENT, 'Drupal (+http://drupal.org/)');
    curl_setopt($ch, CURLOPT_HEADER, 1);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $request->method);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_URL, $request
      ->url());

    // Only add Content-Length if we actually have any content or if it is a POST
    // or PUT request. Some non-standard servers get confused by Content-Length in
    // at least HEAD/GET requests, and Squid always requires Content-Length in
    // POST/PUT requests.
    $content_length = strlen($request->data);
    if ($content_length > 0 || $request->method == 'POST' || $request->method == 'PUT') {
      curl_setopt($ch, CURLOPT_POSTFIELDS, $request->data);
    }
    curl_setopt($ch, CURLOPT_HTTPHEADER, $request
      ->getHeaders());
    curl_setopt_array($ch, $curlopts);
    return $ch;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
HttpClientCurlDelegate::curl	public	function	Gets a curl handle for the given request.
HttpClientCurlDelegate::execute		function	Executes a request for the HttpClient. Overrides HttpClientDelegate::execute
HttpClientDelegate::interpretResponse	protected	function	This function interprets a raw http response.