PHP cURL API集成：构建高效稳定的Web服务交互

$ch = curl_init();

$apiBaseUrl = "https://www.somedomain.com/api/";
$endpoint = "en/1001/cat/10"; // 员工类别API端点
$fullUrl = $apiBaseUrl . $endpoint;

curl_setopt($ch, CURLOPT_URL, $fullUrl);
curl_setopt($ch, CURLOPT_POST, true); // 明确指定为POST请求
// 或者使用：curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");

$apiKey = "123qwe456rty678yui";
// 对apiKey的值进行URL编码
$postData = "apiKey=" . urlencode($apiKey);

curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/x-www-form-urlencoded"
));

// 仅在开发/测试环境中使用，生产环境请务必启用SSL验证
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); // 0 for disabled, 2 for enabled (for older cURL)

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容而不是直接输出

$response = curl_exec($ch);
$err = curl_error($ch); // 获取cURL错误信息
$errNo = curl_errno($ch); // 获取cURL错误码

curl_close($ch);

<?php

/**
 * PHP cURL API调用示例：获取员工类别数据
 * 遵循API规范：POST请求，application/x-www-form-urlencoded，API Key在请求体中
 */

function callApi($endpoint, $apiKey, $page = null) {
    $apiBaseUrl = "https://www.somedomain.com/api/";
    $fullUrl = $apiBaseUrl . $endpoint;

    // 如果指定了页码，则添加到URL中
    if ($page !== null && $page > 1) {
        $fullUrl .= "/page/" . (int)$page;
    }

    $ch = curl_init();

    // 1. 设置请求URL
    curl_setopt($ch, CURLOPT_URL, $fullUrl);

    // 2. 设置为POST请求
    curl_setopt($ch, CURLOPT_POST, true);

    // 3. 设置POST数据：API Key
    // 注意：对值进行URL编码
    $postData = "apiKey=" . urlencode($apiKey);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);

    // 4. 设置HTTP请求头：Content-Type
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        "Content-Type: application/x-www-form-urlencoded"
    ));

    // 5. 配置其他cURL选项
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);          // 设置超时时间（秒）
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);   // 设置连接超时时间（秒）
    curl_setopt($ch, CURLOPT_ENCODING, "");         // 处理所有编码
    curl_setopt($ch, CURLOPT_MAXREDIRS, 10);        // 最大重定向次数

    // 6. SSL/TLS验证（开发/测试环境可禁用，生产环境务必启用）
    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // 生产环境建议设置为true
    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);   // 生产环境建议设置为2
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 禁用对等证书验证
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);    // 禁用主机名验证

    // 7. 开启详细模式（用于调试，生产环境关闭）
    // curl_setopt($ch, CURLOPT_VERBOSE, true);

    // 执行cURL请求
    $response = curl_exec($ch);
    $err = curl_error($ch);
    $errNo = curl_errno($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 获取HTTP状态码

    // 关闭cURL会话
    curl_close($ch);

    // 处理错误
    if ($err) {
        echo "cURL Error (" . $errNo . "): " . $err . PHP_EOL;
        return null;
    } else {
        echo "HTTP Status Code: " . $httpCode . PHP_EOL;
        // 尝试解码JSON响应
        $decodedResponse = json_decode($response, true);

        if (json_last_error() === JSON_ERROR_NONE) {
            echo "API Response (JSON Decoded): " . PHP_EOL;
            print_r($decodedResponse);
            return $decodedResponse;
        } else {
            echo "API Response (Raw): " . PHP_EOL;
            echo $response . PHP_EOL;
            echo "JSON Decode Error: " . json_last_error_msg() . PHP_EOL;
            return $response; // 返回原始响应，以便进一步检查
        }
    }
}

// 调用示例
$myApiKey = "123qwe456rty678yui"; // 替换为您的实际API密钥
$employeesEndpoint = "en/1001/cat/10"; // 员工类别API端点

echo "--- 获取第一页员工数据 ---" . PHP_EOL;
$employeesDataPage1 = callApi($employeesEndpoint, $myApiKey);

echo PHP_EOL . "--- 获取第二页员工数据 ---" . PHP_EOL;
// 假设API支持分页，请求第二页
$employeesDataPage2 = callApi($employeesEndpoint, $myApiKey, 2);

?>