PHP cURL句柄复用中回调函数及选项的有效重置方法

<?php

/**
 * PHP cURL句柄重用与选项重置教程示例
 *
 * 本示例演示了如何使用 curl_reset() 函数在重用 cURL 句柄时，
 * 有效地管理和重置不同的 cURL 选项，特别是回调函数。
 */

// 定义一组通用的 cURL 选项
// 这些选项在大多数请求中都可能需要，可以在每次重置后重新应用
$commonOptions = [
    CURLOPT_RETURNTRANSFER => true, // 获取返回的字符串
    CURLOPT_TIMEOUT        => 30,   // 设置超时时间为30秒
    CURLOPT_FOLLOWLOCATION => true, // 允许重定向
    CURLOPT_MAXREDIRS      => 5,    // 最大重定向次数
    CURLOPT_SSL_VERIFYPEER => false, // 生产环境请设置为 true 并配置证书
    CURLOPT_SSL_VERIFYHOST => false, // 生产环境请设置为 2 并配置证书
];

// 1. 初始化 cURL 句柄
$ch = curl_init();

echo "--- 第一次请求：带自定义 Header 回调 ---" . PHP_EOL;

// 为第一次请求设置特定的 URL 和自定义 Header 回调
$firstRequestOptions = $commonOptions;
$firstRequestOptions[CURLOPT_URL] = 'https://httpbin.org/get'; // 使用一个测试 API
$firstRequestOptions[CURLOPT_HEADERFUNCTION] = function ($ch_handle, $header_line) {
    // 仅处理非空行，并打印
    $trimmed_header = trim($header_line);
    if (!empty($trimmed_header)) {
        echo "  [Header - 首次请求]: " . $trimmed_header . PHP_EOL;
    }
    return strlen($header_line); // cURL 要求返回已处理的字节数
};

// 应用所有选项并执行请求
curl_setopt_array($ch, $firstRequestOptions);
$response1 = curl_exec($ch);

// 检查错误
if (curl_errno($ch)) {
    echo 'cURL 错误 (首次请求): ' . curl_error($ch) . PHP_EOL;
} else {
    echo "首次请求完成。您应该看到自定义 Header 回调的输出。" . PHP_EOL;
    // echo "响应内容 (首次请求): " . substr($response1, 0, 200) . "..." . PHP_EOL; // 打印部分响应
}
echo PHP_EOL;

echo "--- 第二次请求：重置句柄，移除 Header 回调 ---" . PHP_EOL;

// 2. 关键步骤：重置 cURL 句柄的所有选项
// 这会清除所有之前设置的选项，包括 CURLOPT_HEADERFUNCTION
curl_reset($ch);

// 为第二次请求重新应用通用选项，并设置新的 URL 和 POST 数据
$secondRequestOptions = $commonOptions;
$secondRequestOptions[CURLOPT_URL] = 'https://httpbin.org/post'; // 另一个测试 API
$secondRequestOptions[CURLOPT_POST] = true;
$postData = ['key' => 'value', 'reset_test' => true];
$secondRequestOptions[CURLOPT_POSTFIELDS] = json_encode($postData);
$secondRequestOptions[CURLOPT_HTTPHEADER] = ['Content-Type: application/json'];

// 注意：这里没有设置 CURLOPT_HEADERFUNCTION，因此之前的回调将不再生效

// 应用所有选项并执行请求
curl_setopt_array($ch, $secondRequestOptions);
$response2 = curl_exec($ch);

// 检查错误
if (curl_errno($ch)) {
    echo 'cURL 错误 (第二次请求): ' . curl_error($ch) . PHP_EOL;
} else {
    echo "第二次请求完成。不应再有自定义 Header 回调的输出。" . PHP_EOL;
    // echo "响应内容 (第二次请求): " . substr($response2, 0, 200) . "..." . PHP_EOL;
}
echo PHP_EOL;

echo "--- 第三次请求：再次重置句柄，设置不同的 Header 回调 ---" . PHP_EOL;

// 3. 再次重置句柄，为第三次请求做准备
curl_reset($ch);

// 为第三次请求重新应用通用选项，设置新的 URL 和不同的 Header 回调
$thirdRequestOptions = $commonOptions;
$thirdRequestOptions[CURLOPT_URL] = 'https://httpbin.org/get?param=test3';
$thirdRequestOptions[CURLOPT_HEADERFUNCTION] = function ($ch_handle, $header_line) {
    $trimmed_header = trim($header_line);
    if (!empty($trimmed_header)) {
        echo "  [Header - 第三次请求]: " . strtoupper($trimmed_header) . PHP_EOL; // 不同的处理方式
    }
    return strlen($header_line);
};

// 应用所有选项并执行请求
curl_setopt_array($ch, $thirdRequestOptions);
$response3 = curl_exec($ch);

// 检查错误
if (curl_errno($ch)) {
    echo 'cURL 错误 (第三次请求): ' . curl_error($ch) . PHP_EOL;
} else {
    echo "第三次请求完成。您应该看到新的自定义 Header 回调的输出。" . PHP_EOL;
    // echo "响应内容 (第三次请求): " . substr($response3, 0, 200) . "..." . PHP_EOL;
}
echo PHP_EOL;

// 4. 关闭 cURL 句柄，释放资源
curl_close($ch);

?>