当前位置：首页 > 文章列表 > 文章 > php教程 > PHPcurl发送请求教程详解

PHPcurl发送请求教程详解

2025-11-07 09:19:52 0浏览收藏

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《PHP用curl发送HTTP请求教程》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

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

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

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

直接输出解决方案即可

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

基本GET请求

<?php
// 1. 初始化cURL会话
$ch = curl_init();

// 2. 设置cURL选项
// 设置请求的URL
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/data");
// 告诉cURL，不直接输出内容，而是返回到变量中
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 如果是HTTPS，通常需要验证SSL证书，生产环境强烈建议开启
// 但在开发测试时，有时为了方便会临时关闭，但要清楚风险
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

// 3. 执行cURL请求
$response = curl_exec($ch);

// 4. 检查是否有错误发生
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    // 成功获取到响应
    echo 'Response: ' . $response;
}

// 5. 关闭cURL会话，释放资源
curl_close($ch);
?>

发送POST请求

POST请求通常伴随着数据的提交。这里我们需要额外设置CURLOPT_POST为true，并通过CURLOPT_POSTFIELDS传递要发送的数据。数据可以是字符串（如JSON、URL编码的表单数据），也可以是关联数组。

<?php
$ch = curl_init();

$postData = [
    'name' => '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() 与 Stream Context

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

优势:
- 简单易用: 对于简单的GET请求，一行代码就能搞定。
- 无需扩展: PHP安装即可用，不需要额外的配置。
劣势:
- 功能有限: 对于复杂的请求（如设置自定义请求头、处理Cookie、高级认证等），需要通过构建stream context数组来配置，这过程往往比cURL更繁琐且不够直观。
- 错误处理不便: 错误信息通常比较模糊，难以定位问题。
- 性能一般: 对于大量并发或持续的请求，性能不如cURL。
- POST请求复杂: 发送POST数据需要手动构建http上下文，并指定method、header和content。
适用场景: 快速获取一个网页内容、简单的API调用，对功能要求不高的场景。

<?php
// 示例：使用file_get_contents发送GET请求
$response = file_get_contents('https://api.example.com/data');

// 示例：使用file_get_contents发送POST请求
$postData = http_build_query(['key' => '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客户端、微服务间通信等。

<?php
// 示例：使用Guzzle发送请求 (需要先通过Composer安装：composer require guzzlehttp/guzzle)
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();
try {
    $response = $client->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等。在cURL中，我们通过CURLOPT_HTTPHEADER选项来设置。它接受一个字符串数组，每个字符串代表一个完整的HTTP头。

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/secured-data");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 设置自定义请求头
$headers = [
    'Content-Type: application/json', // 告诉服务器我们发送的是JSON数据
    'Authorization: Bearer YOUR_ACCESS_TOKEN', // 用于OAuth2等认证
    'User-Agent: MyPhpApp/1.0 (https://my-app.com)', // 自定义User-Agent
    'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' // 告知服务器接受的语言
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

// 如果是POST请求，并且Content-Type是application/json，还需要设置POSTFIELDS
$postData = json_encode(['param1' => '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文档的要求进行精确配置。

今天关于《PHPcurl发送请求教程详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Http请求,常见问题,Guzzle,PHPcURL,请求配置的内容请关注golang学习网公众号！

Http请求常见问题 Guzzle PHPcURL 请求配置