php怎么发送http请求_php使用curl发送请求教程

答案：PHP发送HTTP请求最推荐使用cURL扩展，因其功能全面、灵活性高，支持GET、POST、自定义请求头、Cookie管理、SSL配置及多种认证方式，适用于复杂网络通信场景。

PHP发送HTTP请求，最直接且功能最全面的方式，毋庸置疑就是通过cURL扩展。它就像一个瑞士军刀，能处理几乎所有你可能遇到的网络通信场景，从简单的GET请求到复杂的认证、文件上传，都能游刃有余地搞定。如果你需要与外部API交互，或者从其他服务获取数据，cURL绝对是PHP生态里最稳健的选择。

直接输出解决方案即可

要用PHP的cURL发送HTTP请求，核心逻辑其实就那么几步，但每一步都有其存在的道理。我们先从一个最基础的GET请求开始，然后逐步深入到POST和其他常用配置。

基本GET请求

立即学习“PHP免费学习笔记（深入）”；

发送POST请求

POST请求通常伴随着数据的提交。这里我们需要额外设置

CURLOPT_POST

true

CURLOPT_POSTFIELDS

 'John Doe',
    'email' => 'john.doe@example.com'
];

curl_setopt($ch, CURLOPT_URL, "https://api.example.com/submit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true); // 明确这是一个POST请求
// 如果是数组，cURL会自动将其转换为URL编码的字符串
// 如果是JSON，你需要先json_encode，并设置Content-Type头
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);

// 假设API需要JSON格式的数据，你需要这样做：
/*
$jsonData = json_encode($postData);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($jsonData)
]);
*/

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo 'Response: ' . $response;
}

curl_close($ch);
?>

一些常用的cURL选项

• CURLOPT_TIMEOUT

  : 设置cURL操作的最长执行时间（秒）。

• CURLOPT_CONNECTTIMEOUT

  : 设置连接等待时间（秒）。

• CURLOPT_HTTPHEADER

  : 设置自定义的HTTP请求头，以数组形式传递。例如：

  ['Authorization: Bearer YOUR_TOKEN', 'Accept: application/json']

  。

• CURLOPT_FOLLOWLOCATION

  : 当目标URL发生重定向时，cURL是否自动跟踪。

• CURLOPT_USERAGENT

  : 设置User-Agent字符串，模拟浏览器行为。

• CURLOPT_COOKIEJAR

  /

  CURLOPT_COOKIEFILE

  : 用于处理Cookie，可以将服务器返回的Cookie保存到文件，或从文件中读取Cookie发送。

cURL的强大之处在于它的灵活性和丰富的功能，几乎可以满足所有HTTP请求的需求。掌握这些基础，你就能在PHP中畅通无阻地进行网络通信了。

PHP cURL在实际项目中常见的问题和解决方案是什么？

说实话，cURL虽然功能强大，但用起来也确实有些“小脾气”，尤其是在处理一些边缘情况时，总能遇到些让人头疼的问题。在我看来，最常见的几个痛点和它们的解决思路是这样的：

1. SSL证书验证问题

这是新手最容易遇到的，尤其是在对接一些自签名证书或者内部服务时。cURL默认会严格验证SSL证书的有效性，如果验证失败，就会报错。

• 问题表现:

  cURL Error: SSL certificate problem: unable to get local issuer certificate

  或

  Peer certificate cannot be authenticated with known CA certificates

  。
• 解决方案:
  • 正确做法（生产环境强烈推荐）: 配置

    CURLOPT_CAINFO

    指向一个包含信任CA证书的PEM文件（通常是

    cacert.pem

    ），或者确保服务器环境的CA证书库是最新的。
  • 临时做法（开发测试环境慎用）: 关闭SSL验证。设置

    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

    和

    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

    。请注意，这会使你的连接容易受到中间人攻击，仅在你知道风险并仅用于非敏感的开发测试时使用。

2. 请求超时

网络环境复杂多变，请求超时是家常便饭。如果一个请求挂起太久，会阻塞你的PHP进程，影响用户体验甚至导致服务器资源耗尽。

• 问题表现:

  cURL Error: Operation timed out after X milliseconds with Y bytes received

  。
• 解决方案:
  • 设置合理的超时时间:

    curl_setopt($ch, CURLOPT_TIMEOUT, 10);

    （总超时10秒）和

    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

    （连接超时5秒）。根据目标服务的响应速度和网络状况调整。
  • 增加重试机制: 在代码层面实现简单的重试逻辑，当第一次请求超时后，等待片刻再尝试一次。
  • 异步请求: 对于大量耗时请求，考虑使用多线程（如

    curl_multi_*

    系列函数）或异步HTTP客户端（如Guzzle）来避免阻塞。

3. POST数据编码和格式

POST数据发送时，不同的API可能要求不同的

Content-Type

application/x-www-form-urlencoded

application/json

multipart/form-data

• 问题表现: API返回“无效数据”或“请求体格式错误”。
• 解决方案:

  • application/x-www-form-urlencoded

    : 直接将关联数组传递给

    CURLOPT_POSTFIELDS

    ，cURL会自动处理。或者使用

    http_build_query()

    手动构建字符串。

  • application/json

    : 先用

    json_encode()

    将数据转换为JSON字符串，然后设置

    CURLOPT_POSTFIELDS

    为该字符串，并务必通过

    CURLOPT_HTTPHEADER

    设置

    Content-Type: application/json

    。

  • multipart/form-data

    (文件上传): 使用

    CURLFile

    对象来指定文件。例如：

    'file' => new CURLFile('/path/to/your/file.jpg', 'image/jpeg', 'filename.jpg')

    。对于旧版PHP，可能需要使用

    '@/path/to/your/file.jpg'

    这种格式，但现在不推荐。

4. 重定向处理

有些服务在处理请求后会返回3xx状态码进行重定向。

• 问题表现: 拿到的响应是重定向页面的内容，而不是最终目标页面的内容。
• 解决方案:
  • 自动跟踪重定向: 设置

    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

    。但要注意，如果重定向次数过多或形成循环，可能会导致无限循环，cURL默认限制重定向次数为20，可以通过

    CURLOPT_MAXREDIRS

    调整。
  • 手动处理重定向: 如果需要更精细的控制，可以不设置

    CURLOPT_FOLLOWLOCATION

    ，而是通过

    curl_getinfo($ch, CURLINFO_HTTP_CODE)

    获取状态码，然后解析响应头中的

    Location

    字段，手动发起新的请求。

除了cURL，PHP还有哪些发送HTTP请求的方式？它们各自的优劣如何？

cURL确实是PHP里处理HTTP请求的“主力军”，但它并不是唯一的选择。根据不同的场景和需求，我们有时也会考虑其他方案。每种方式都有其独特的优势和局限性。

1.

file_get_contents()

LobeHub

LobeChat brings you the best user experience of ChatGPT, OLLaMA, Gemini, Claude

下载

这是PHP内置的功能，无需任何扩展，非常轻量。

• 优势:
  • 简单易用: 对于简单的GET请求，一行代码就能搞定。
  • 无需扩展: PHP安装即可用，不需要额外的配置。
• 劣势:
  • 功能有限: 对于复杂的请求（如设置自定义请求头、处理Cookie、高级认证等），需要通过构建

    stream context

    数组来配置，这过程往往比cURL更繁琐且不够直观。
  • 错误处理不便: 错误信息通常比较模糊，难以定位问题。
  • 性能一般: 对于大量并发或持续的请求，性能不如cURL。
  • POST请求复杂: 发送POST数据需要手动构建

    http

    上下文，并指定

    method

    、

    header

    和

    content

    。
• 适用场景: 快速获取一个网页内容、简单的API调用，对功能要求不高的场景。

 'value']);
$options = [
    'http' => [
        'method' => 'POST',
        'header' => 'Content-type: application/x-www-form-urlencoded',
        'content' => $postData,
        'timeout' => 10 // 设置超时
    ]
];
$context = stream_context_create($options);
$response = file_get_contents('https://api.example.com/submit', false, $context);
?>

2. Guzzle HTTP Client

Guzzle是一个非常流行的PHP HTTP客户端库，通过Composer安装，提供了一个现代、面向对象的API来发送HTTP请求。

• 优势:
  • 现代API: 提供链式调用、中间件、异步请求等高级功能，代码可读性高。
  • 功能强大: 几乎涵盖cURL的所有功能，并提供了更友好的封装，如自动处理JSON、表单数据、文件上传等。
  • 社区活跃: 拥有庞大的用户群和良好的文档支持。
  • 易于测试: 提供了模拟响应机制，方便单元测试。
• 劣势:
  • 需要Composer: 对于小型、不使用Composer的项目来说，引入Guzzle可能显得有点重。
  • 学习曲线: 相对于cURL的直接操作，Guzzle有自己的抽象层和概念，需要一定的学习成本。
• 适用场景: 几乎所有需要进行HTTP请求的现代PHP项目，特别是大型应用、API客户端、微服务间通信等。

request('GET', 'https://api.example.com/data');
    echo $response->getBody();

    $response = $client->request('POST', 'https://api.example.com/submit', [
        'json' => ['name' => 'Jane Doe'] // 自动设置Content-Type: application/json
    ]);
    echo $response->getBody();
} catch (GuzzleHttp\Exception\RequestException $e) {
    echo $e->getMessage();
}
?>

3. Symfony HttpClient (或类似PSR-18兼容客户端)

Symfony HttpClient是Symfony框架提供的一个组件，但也可以独立使用。它实现了PSR-18 (HTTP Client) 规范，意味着你可以轻松替换底层的HTTP客户端实现。

• 优势:
  • PSR-18兼容: 提供了标准化的接口，易于与其他PSR兼容组件集成。
  • 性能优化: 内部对HTTP/2、连接池等有很好的支持。
  • 功能全面: 同样提供了强大的请求构建、响应处理、错误处理等功能。
  • 与框架集成度高: 在Symfony或使用Symfony组件的项目中表现出色。
• 劣势:
  • 学习曲线: 同样有自己的抽象和概念。
  • 通常与框架生态绑定: 虽然可以独立使用，但在非Symfony项目中可能不如Guzzle那么普及。
• 适用场景: 大型项目、微服务架构、需要高度可插拔和标准化HTTP客户端的场景。

总的来说，对于大多数PHP开发者而言，cURL是基础，也是必须掌握的技能。而对于现代、复杂的项目，Guzzle或Symfony HttpClient这样的高级库能大大提升开发效率和代码质量。

file_get_contents()

如何在PHP cURL中设置请求头、处理Cookie和进行身份验证？

在与各种API和服务打交道时，设置正确的请求头、管理Cookie以及进行身份验证是必不可少的环节。cURL在这方面提供了非常精细的控制能力。

1. 设置请求头 (

CURLOPT_HTTPHEADER

HTTP请求头是客户端与服务器之间传递元数据的重要方式。例如，指定

Content-Type

User-Agent

Authorization

CURLOPT_HTTPHEADER

 'value1']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo 'Response: ' . $response;
}
curl_close($ch);
?>

2. 处理Cookie

Cookie在HTTP通信中扮演着重要的角色，用于会话管理、用户跟踪等。cURL提供了几种方式来发送和接收Cookie。

• 发送Cookie (

  CURLOPT_COOKIE

  ): 如果你知道要发送的Cookie字符串，可以直接通过这个选项设置。

  curl_setopt($ch, CURLOPT_COOKIE, 'PHPSESSID=abcdef123; user_id=12345');

• 保存/读取Cookie文件 (

  CURLOPT_COOKIEJAR

  ,

  CURLOPT_COOKIEFILE

  ): 这是更常用且推荐的方式，尤其是需要模拟浏览器行为时。

  CURLOPT_COOKIEJAR

  告诉cURL将所有收到的Cookie保存到指定文件，而

  CURLOPT_COOKIEFILE

  则让cURL在发送请求时从指定文件读取Cookie。

  $cookieFile = '/tmp/my_cookies.txt'; // 确保PHP有写入权限
  
  // 第一次请求：登录，并保存服务器返回的Cookie
  $ch1 = curl_init();
  curl_setopt($ch1, CURLOPT_URL, 'https://api.example.com/login');
  curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch1, CURLOPT_POST, true);
  curl_setopt($ch1, CURLOPT_POSTFIELDS, ['username' => 'test', 'password' => 'pass']);
  curl_setopt($ch1, CURLOPT_COOKIEJAR, $cookieFile); // 将Cookie保存到文件
  curl_exec($ch1);
  curl_close($ch1);
  
  // 第二次请求：访问需要认证的页面，自动带上之前保存的Cookie
  $ch2 = curl_init();
  curl_setopt($ch2, CURLOPT_URL, 'https://api.example.com/dashboard');
  curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch2, CURLOPT_COOKIEFILE, $cookieFile); // 从文件读取Cookie发送
  $dashboardContent = curl_exec($ch2);
  if (curl_errno($ch2)) {
      echo 'cURL Error: ' . curl_error($ch2);
  } else {
      echo 'Dashboard: ' . $dashboardContent;
  }
  curl_close($ch2);

3. 进行身份验证

cURL支持多种身份验证机制，最常见的有HTTP基本认证和Bearer Token认证。

• HTTP基本认证 (Basic Auth): 这是一种简单的认证方式，通过在请求头中发送Base64编码的用户名和密码。cURL提供了专门的选项来处理。

  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, "https://api.example.com/basic-auth-endpoint");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); // 指定认证方式为基本认证
  curl_setopt($ch, CURLOPT_USERPWD, 'username:password'); // 设置用户名和密码
  
  $response = curl_exec($ch);
  // ... 错误处理和响应解析
  curl_close($ch);

• Bearer Token 认证: 这种方式在OAuth2等现代认证流程中非常常见，通常是将一个Token放在

  Authorization

  请求头中。这其实就是通过

  CURLOPT_HTTPHEADER

  来设置。

  $accessToken = 'YOUR_GENERATED_BEARER_TOKEN';
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, "https://api.example.com/oauth2-protected-resource");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Authorization: Bearer ' . $accessToken, // 将Token放在Authorization头中
      'Content-Type: application/json'
  ]);
  // ... 其他请求设置，如POST数据
  $response = curl_exec($ch);
  // ... 错误处理和响应解析
  curl_close($ch);

通过这些选项的组合使用，cURL能够满足绝大多数复杂的HTTP通信需求。关键在于理解每个选项的作用，并根据API文档的要求进行精确配置。