PHP 中 cURL 从入门到精通的使用教程
在 PHP 开发中，cURL 是进行 HTTP/HTTPS 请求的重要工具，可模拟浏览器行为访问接口、抓取网页或上传下载文件。本文面向新手，系统讲解 cURL 的基础用法与常见场景，并提供可直接运行的示例代码，帮助快速掌握并避免常见错误。
一、cURL 基础概念
cURL（Client URL Library）是一个支持多协议的传输库，PHP 通过 curl_* 系列函数对其进行封装。常用场景包括：
- 调用 RESTful API
- 抓取远程页面数据
- 模拟 POST/GET/PUT/DELETE 请求
- 上传文件、处理 Cookie 与 Header
使用 cURL 前需确保 PHP 已启用 cURL 扩展（可通过 phpinfo() 检查）。
二、基本 GET 请求
最简单的用法是直接获取一个 URL 的内容。以下示例演示如何发起 GET 请求并读取返回数据：
$ch = curl_init('http://www.ipipp.com/api/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'cURL Error: ' . curl_error($ch);
}
curl_close($ch);
echo $response; 要点说明：
- CURLOPT_RETURNTRANSFER 设为 true 可使结果以字符串返回而不是直接输出。
- CURLOPT_TIMEOUT 防止请求长时间阻塞。
- 必须检测 curl_errno 捕获网络或协议错误。
三、POST 请求与发送数据
向接口提交数据时常用 POST 方法。示例演示发送 JSON 格式数据：
$data = ['name' => 'test', 'value' => 123];
$jsonData = json_encode($data);
$ch = curl_init('http://www.ipipp.com/api/submit');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
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);
}
curl_close($ch);
echo $response; 注意：
- 当发送 JSON 时，要设置正确的 Content-Type 并计算长度。
- 若接口要求表单格式，可用 http_build_query($data) 生成 key=value&... 字符串并设置 application/x-www-form-urlencoded。
四、自定义请求头与 User-Agent
有些服务器会校验客户端身份，此时需添加 Header 或伪装浏览器：
$ch = curl_init('http://www.ipipp.com/page');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MyBot/1.0)');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-Custom-Header: MyValue',
'Authorization: Bearer your_token_here'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;五、处理 HTTPS 与证书验证
默认情况下，cURL 会验证 HTTPS 证书，如目标站点证书无效则会失败。可在测试环境临时关闭验证（生产环境不推荐）：
$ch = curl_init('https://www.ipipp.com/secure');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 关闭证书验证
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$response = curl_exec($ch);
curl_close($ch);
echo $response;生产环境应使用有效证书或指定 CA 包路径：
curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem'); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
六、文件上传
上传文件需使用 CURLFile 类构造 multipart/form-data 请求：
$filePath = '/path/to/upload.jpg';
$cfile = new CURLFile($filePath, 'image/jpeg', 'upload.jpg');
$postData = ['file' => $cfile, 'desc' => 'Test upload'];
$ch = curl_init('http://www.ipipp.com/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;七、错误调试与信息获取
开发阶段可利用 curl_getinfo 查看请求详情，便于定位问题：
$ch = curl_init('http://www.ipipp.com/api');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error: ' . curl_error($ch);
} else {
$info = curl_getinfo($ch);
echo 'HTTP Code: ' . $info['http_code'] . "n";
echo 'Total time: ' . $info['total_time'] . "sn";
}
curl_close($ch);八、封装可复用的请求函数
为减少重复代码，可将常用逻辑封装成函数：
function httpRequest($url, $method = 'GET', $data = [], $headers = []) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
if (strtoupper($method) === 'POST') {
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
}
if (!empty($headers)) {
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
}
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
return $error ? ['error' => $error] : $response;
}
// 使用示例
$result = httpRequest('http://www.ipipp.com/api', 'POST', json_encode(['a'=>1]), ['Content-Type: application/json']);
print_r($result);九、常见错误及修复建议
1. **未开启 cURL 扩展**：在 php.ini 中取消注释 extension=curl 并重启服务。
2. **超时未设或太短**：根据目标服务器响应速度合理设置 CURLOPT_TIMEOUT。
3. **HTTPS 证书报错**：生产环境务必验证证书，测试时可临时关闭验证。
4. **POST 数据格式不符**：JSON 请求需设置对应 Header，表单请求用 http_build_query。
5. **忘记释放句柄**：每次请求后调用 curl_close 防止资源泄漏。
十、总结
通过本文的示例与解析，可以从零掌握 PHP cURL 的基本用法与进阶技巧。关键点在于理解各选项的作用、正确处理数据与错误、以及在生产环境中遵循安全规范。熟练掌握 cURL 能显著提升与第三方服务交互的效率与稳定性，是 PHP 开发者必备技能之一。