php curl的使用

在 PHP 中，cURL 是一个强大的库，用于与各种服务器进行通信（支持 HTTP、HTTPS、FTP 等协议）。以下是 cURL 的详细实现步骤和示例代码：

基本使用步骤

1. 初始化会话：curl_init()

2. 设置选项：curl_setopt()

3. 执行请求：curl_exec()

4. 关闭会话：curl_close()

5. 错误处理：curl_errno(), curl_error()

GET 请求示例

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

// 2. 设置请求 URL
$url = "https://jsonplaceholder.typicode.com/posts/1";
curl_setopt($ch, CURLOPT_URL, $url);

// 3. 设置返回响应而非直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 4. 可选：设置超时时间（秒）
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

// 5. 执行请求并获取响应
$response = curl_exec($ch);

// 6. 检查错误
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    // 处理响应（例如 JSON 解析）
    $data = json_decode($response, true);
    print_r($data);
}

// 7. 关闭会话
curl_close($ch);
?>

POST 请求示例

<?php
$ch = curl_init();
$url = "https://jsonplaceholder.typicode.com/posts";

// POST 数据（表单格式）
$postData = [
    'title' => 'Test Post',
    'body' => 'This is a test post.',
    'userId' => 1
];

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true); // 启用 POST
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData)); // 编码数据

// 设置请求头（可选）
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded',
]);

$response = curl_exec($ch);

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

curl_close($ch);
?>

高级选项设置

1. 设置请求头

$headers = [
    'Authorization: Bearer YOUR_ACCESS_TOKEN',
    'Content-Type: application/json',
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

2. 发送 JSON 数据

$jsonData = json_encode(['key' => 'value']);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

3. 获取响应头信息

curl_setopt($ch, CURLOPT_HEADER, true); // 包含响应头
$response = curl_exec($ch);

// 分离头部和主体
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headers = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);

4. 处理 HTTPS 证书

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 不验证证书（测试环境）
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // 不验证主机名

5. 跟随重定向

curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); // 自动跟随重定向
curl_setopt($ch, CURLOPT_MAXREDIRS, 5); // 最大重定向次数

调试与错误处理

// 获取 HTTP 状态码
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo "Status Code: " . $httpCode;

// 获取请求总时间
$totalTime = curl_getinfo($ch, CURLINFO_TOTAL_TIME);
echo "Request Time: " . $totalTime . " seconds";

完整封装函数示例

function curlRequest($url, $method = 'GET', $data = null, $headers = []) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);

    if ($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);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return [
        'code' => $httpCode,
        'response' => $response,
        'error' => $error
    ];
}

// 使用示例
$result = curlRequest(
    'https://api.example.com/data',
    'POST',
    json_encode(['param' => 'value']),
    ['Content-Type: application/json']
);
print_r($result);

常见问题解决

1. 请求超时：增加 CURLOPT_TIMEOUT 值。

2. SSL 证书错误：

   • 正式环境：下载 CA 证书并设置 CURLOPT_CAINFO。

   • 测试环境：临时禁用验证（不推荐生产环境使用）。

3. 返回乱码：

   curl_setopt($ch, CURLOPT_ENCODING, 'gzip, deflate'); // 自动解压

通过以上示例，你可以快速实现 GET/POST 请求、处理 JSON 数据、设置请求头和调试错误。根据实际需求调整参数即可。