PHP发送HTTP请求的几种方法对比

PHP中发送HTTP请求是常见的开发需求，用于访问API接口、抓取网页等。本文对比了PHP发送HTTP请求的几种常用方式，包括`file_get_contents`、`fopen`结合`stream_context_create`、`cURL`扩展以及`Guzzle HTTP Client`。`file_get_contents`简单易用，适合简单的GET请求；`fopen`方式更灵活，可自定义请求参数；`cURL`功能强大，支持各类请求和详细配置，适合复杂场景，但使用稍复杂；`Guzzle`基于`cURL`，提供更简洁的API，易于使用且功能丰富，但需引入第三方依赖。文章还深入探讨了超时处理、POST请求发送、响应头获取等关键问题，并提供了详细的代码示例，助你选择最适合的HTTP请求方案。

PHP中发送HTTP请求的常见方式包括file_get_contents、fopen结合stream_context_create、cURL扩展及Guzzle客户端。file_get_contents适用于简单GET请求，使用方便但功能有限；fopen方式可自定义部分请求参数，灵活性适中；cURL功能强大，支持各类请求和详细配置，适合复杂场景；Guzzle基于cURL，提供更简洁的API，易于使用且功能丰富，但需引入第三方依赖。性能方面，简单请求file_get_contents开销小，复杂请求cURL效率更高。处理超时方面，cURL可通过CURLOPT_CONNECTTIMEOUT和CURLOPT_TIMEOUT设置，Guzzle则通过timeout选项并在异常中捕获超时。发送POST请求时，cURL使用CURLOPT_POST和CURLOPT_POSTFIELDS，Guzzle通过form_params或json选项传递数据。获取响应头时，cURL需启用CURLOPT_HEADER并手动解析，Guzzle则提供getHeaderLine和getHeaders方法直接获取。

PHP中发送HTTP请求，简单来说，就是让你的PHP程序能够像浏览器一样，去访问其他的网站或者API接口，获取数据或者提交数据。这在很多场景下都非常有用，比如调用第三方服务、抓取网页内容等等。

解决方案

PHP提供了多种发送HTTP请求的方式，各有优缺点。最常见的有以下几种：

1. file_get_contents() 函数

   这可能是最简单的方式了，但功能也相对有限。它主要用于获取HTTP响应的内容。

   $url = 'https://www.example.com';
   $content = file_get_contents($url);
   
   if ($content !== false) {
       echo $content;
   } else {
       echo "Failed to fetch content.";
   }

   这种方式的优点是简单易用，缺点是不支持复杂的HTTP请求，比如设置请求头、发送POST数据等。而且，它默认会阻塞程序的执行，直到请求完成。

2. fopen() 函数结合 stream_context_create()

   这种方式比file_get_contents()更灵活一些，可以通过stream_context_create()函数创建上下文，设置请求头、请求方法等。

   $url = 'https://www.example.com';
   $options = array(
       'http' => array(
           'method'  => 'GET',
           'header'  => "Accept-language: en\r\n"
       )
   );
   
   $context  = stream_context_create($options);
   $content = file_get_contents($url, false, $context);
   
   if ($content !== false) {
       echo $content;
   } else {
       echo "Failed to fetch content.";
   }

   这种方式的优点是可以自定义一些HTTP请求的参数，但仍然比较底层，使用起来相对麻烦。

3. cURL 扩展

   cURL (Client URL Library) 是一个功能强大的HTTP客户端库，PHP的cURL扩展提供了对它的封装。这是最常用、最灵活的方式，可以发送各种类型的HTTP请求，设置各种参数。

   $url = 'https://www.example.com';
   
   $ch = curl_init();
   curl_setopt($ch, CURLOPT_URL, $url);
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // 返回内容，不直接输出
   curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 禁用SSL验证，生产环境不建议
   
   $content = curl_exec($ch);
   
   if (curl_errno($ch)) {
       echo 'Error:' . curl_error($ch);
   }
   
   curl_close($ch);
   
   if ($content !== false) {
       echo $content;
   } else {
       echo "Failed to fetch content.";
   }

   cURL的优点是功能强大，支持各种HTTP请求，可以设置各种参数，比如超时时间、请求头、代理等等。缺点是使用起来相对复杂，需要了解cURL的各种选项。 记得开启PHP的cURL扩展。

4. Guzzle HTTP Client

   Guzzle是一个流行的PHP HTTP客户端库，它基于cURL，提供了更简洁、更易用的API。如果你觉得cURL用起来太麻烦，Guzzle是一个不错的选择。

   首先，你需要通过Composer安装Guzzle：

   composer require guzzlehttp/guzzle

   然后，就可以使用Guzzle发送HTTP请求了：

   require 'vendor/autoload.php';
   
   use GuzzleHttp\Client;
   
   $client = new Client();
   $response = $client->request('GET', 'https://www.example.com');
   
   echo $response->getStatusCode(); // 200
   echo $response->getBody(); // 获取响应内容

   Guzzle的优点是API简洁易用，功能强大，支持各种HTTP请求，而且提供了很多方便的功能，比如自动重定向、Cookie管理等等。缺点是需要安装第三方库，会增加项目的依赖。

cURL和file_get_contents性能对比，以及适用场景？

file_get_contents 在简单场景下性能可能略好，因为它实现简单，开销小。但是，一旦涉及到复杂的请求，比如需要设置请求头、超时时间，或者发送POST数据，cURL 的性能优势就体现出来了。cURL 允许更细粒度的控制，能更有效地利用网络资源。

• 适用场景：

  • file_get_contents: 适合简单的GET请求，比如获取静态资源、简单的API接口。
  • cURL: 适合复杂的HTTP请求，比如需要设置请求头、发送POST数据、处理Cookie、使用代理等。 也适合需要更高性能和更灵活控制的场景。

如何处理HTTP请求中的超时问题？

HTTP请求超时是很常见的问题，特别是在网络状况不好的情况下。如果不处理超时，程序可能会一直阻塞，影响用户体验。

• 使用cURL处理超时:

  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10); // 连接超时时间，单位秒
  curl_setopt($ch, CURLOPT_TIMEOUT, 30);       // 总的超时时间，单位秒
  $content = curl_exec($ch);
  
  if (curl_errno($ch) == CURLE_OPERATION_TIMEOUTED) {
      echo "Request timed out.";
  }

  通过CURLOPT_CONNECTTIMEOUT设置连接超时时间，CURLOPT_TIMEOUT设置总的超时时间。如果请求超时，curl_errno()会返回CURLE_OPERATION_TIMEOUTED。

• 使用Guzzle处理超时:

  use GuzzleHttp\Client;
  use GuzzleHttp\Exception\RequestException;
  
  $client = new Client(['timeout'  => 30.0]); // 设置全局超时时间
  try {
      $response = $client->request('GET', 'https://www.example.com');
  } catch (RequestException $e) {
      echo "Request failed: " . $e->getMessage();
  }

  Guzzle 允许设置全局的超时时间，也可以在每次请求时单独设置。如果请求超时，会抛出RequestException异常。

如何发送POST请求并传递数据？

发送POST请求并传递数据是HTTP请求中常见的需求，比如提交表单、上传文件等。

• 使用cURL发送POST请求:

  $url = 'https://www.example.com/api/post';
  $data = array('name' => 'John Doe', 'email' => 'john.doe@example.com');
  
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_POST, 1); // 设置为POST请求
  curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // 设置POST数据
  
  $content = curl_exec($ch);
  curl_close($ch);

  通过CURLOPT_POST设置为POST请求，CURLOPT_POSTFIELDS设置POST数据。POST数据可以是数组，也可以是字符串。如果是数组，cURL会自动将其编码为multipart/form-data格式。

• 使用Guzzle发送POST请求:

  use GuzzleHttp\Client;
  
  $client = new Client();
  $response = $client->request('POST', 'https://www.example.com/api/post', [
      'form_params' => [
          'name' => 'John Doe',
          'email' => 'john.doe@example.com'
      ]
  ]);
  
  echo $response->getBody();

  Guzzle 使用 form_params 选项来设置 POST 数据。Guzzle 会自动将数据编码为 application/x-www-form-urlencoded 格式。 如果需要发送 JSON 数据，可以使用 json 选项。

如何处理HTTP响应头？

HTTP响应头包含了服务器返回的各种信息，比如状态码、内容类型、Cookie等等。

• 使用cURL获取响应头:

  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_HEADER, 1); // 返回响应头
  
  $response = curl_exec($ch);
  $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE); // 获取header大小
  $header = substr($response, 0, $header_size); // 获取header内容
  $body = substr($response, $header_size); // 获取body内容
  curl_close($ch);
  
  // 解析header
  $headers = array();
  $header_lines = explode("\r\n", trim($header));
  foreach ($header_lines as $line) {
      $parts = explode(':', $line, 2);
      if (count($parts) == 2) {
          $headers[trim($parts[0])] = trim($parts[1]);
      }
  }
  
  print_r($headers);

  通过CURLOPT_HEADER设置为1，cURL会将响应头和响应内容一起返回。然后，可以使用curl_getinfo()函数获取header的大小，再使用substr()函数将header和body分开。

• 使用Guzzle获取响应头:

  use GuzzleHttp\Client;
  
  $client = new Client();
  $response = $client->request('GET', 'https://www.example.com');
  
  echo $response->getHeaderLine('Content-Type'); // 获取Content-Type
  print_r($response->getHeaders()); // 获取所有header

  Guzzle 提供了 getHeaderLine() 和 getHeaders() 方法来获取响应头。

今天关于《PHP发送HTTP请求的几种方法对比》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！