PHP cURL请求REST API获取XML响应的全面指南

<?php

/**
 * 发送cURL请求的辅助函数
 *
 * @param string $url 请求URL
 * @param array|null $options cURL选项数组，用于覆盖默认设置
 * @param array|null $headers 请求头数组
 * @return object 包含响应、信息、错误和详细调试输出的对象
 */
function curl( $url=NULL, $options=NULL, $headers=false ){
    // 确保session已关闭，防止在cURL请求期间阻塞其他请求
    session_write_close();

    // CA证书路径，用于HTTPS请求的SSL验证
    // 请从 https://www.php.cn/link/b3c6f53619ce7496216184f880eac8bd 下载 cacert.pem
    // 并将其保存到可访问的路径，例如 c:/wwwroot/cacert.pem
    $cacert = 'c:/wwwroot/cacert.pem'; 

    // 用于捕获cURL详细调试信息的临时文件句柄
    $vbh = fopen('php://temp', 'w+');

    // 初始化结果对象
    $res=array(
        'response'  =>  NULL,
        'info'      =>  array( 'http_code' => 100 ), // 默认 http_code
        'headers'   =>  NULL,
        'errors'    =>  NULL,
        'verbose'   =>  NULL // 详细调试信息
    );
    if( is_null( $url ) ) return (object)$res;

    /* 初始化cURL请求对象 */
    $curl=curl_init();

    /* 配置HTTPS请求的SSL验证 */
    if( parse_url( $url, PHP_URL_SCHEME ) == 'https' ){
        curl_setopt( $curl, CURLOPT_SSL_VERIFYPEER, true ); // 验证对等证书
        curl_setopt( $curl, CURLOPT_SSL_VERIFYHOST, 2 );   // 验证主机名
        curl_setopt( $curl, CURLOPT_CAINFO, $cacert );     // 指定CA证书文件
        curl_setopt( $curl, CURLOPT_CAPATH, $cacert );     // 指定CA证书目录
    }

    /* 定义标准cURL选项 */
    curl_setopt( $curl, CURLOPT_URL, trim( $url ) );
    curl_setopt( $curl, CURLOPT_AUTOREFERER, true );       // 自动设置Referer头
    curl_setopt( $curl, CURLOPT_FOLLOWLOCATION, true );    // 跟踪3xx重定向
    curl_setopt( $curl, CURLOPT_FAILONERROR, false );      // 不在HTTP错误时失败，以便获取错误响应体
    curl_setopt( $curl, CURLOPT_HEADER, false );           // 不在响应中包含头信息
    curl_setopt( $curl, CURLINFO_HEADER_OUT, true );       // 在cURL_getinfo中包含请求头
    curl_setopt( $curl, CURLOPT_RETURNTRANSFER, true );    // 以字符串形式返回响应内容
    curl_setopt( $curl, CURLOPT_BINARYTRANSFER, true );    // 以二进制形式传输
    curl_setopt( $curl, CURLOPT_CONNECTTIMEOUT, 20 );      // 连接超时时间
    curl_setopt( $curl, CURLOPT_TIMEOUT, 60 );             // 整体超时时间
    curl_setopt( $curl, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.38 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.38' ); // 设置User-Agent
    curl_setopt( $curl, CURLOPT_MAXREDIRS, 10 );           // 最大重定向次数
    curl_setopt( $curl, CURLOPT_ENCODING, '' );            // 接受所有编码

    /* 增强调试功能 */
    curl_setopt( $curl, CURLOPT_VERBOSE, true );           // 开启详细输出
    curl_setopt( $curl, CURLOPT_NOPROGRESS, true );        // 关闭进度条
    curl_setopt( $curl, CURLOPT_STDERR, $vbh );            // 将详细输出写入临时文件句柄

    /* 应用运行时参数，覆盖默认设置 */
    if( isset( $options ) && is_array( $options ) ){
        foreach( $options as $param => $value ) curl_setopt( $curl, $param, $value );
    }

    /* 发送请求头 */
    if( $headers && is_array( $headers ) ){
        curl_setopt( $curl, CURLOPT_HTTPHEADER, $headers );
    }

    /* 执行请求并存储响应 */
    $res=(object)array(
        'response'  =>  curl_exec( $curl ),
        'info'      =>  (object)curl_getinfo( $curl ),
        'errors'    =>  curl_error( $curl )
    );

    // 获取详细调试信息
    rewind( $vbh ); // 将文件指针重置到开头
    $res->verbose = stream_get_contents( $vbh ); // 读取所有内容
    fclose( $vbh ); // 关闭文件句柄

    curl_close( $curl ); // 关闭cURL资源
    return $res;
}

<?php
// 引入上面定义的 curl 函数
// require_once 'curl_helper.php'; 

$url = 'https://your-api-domain.com/api/login'; // 替换为您的API登录URL

// 构造POST请求体数据
// 如果API期望XML，这里应该是一个XML字符串
$post_data_xml = <<<XML
<?xml version="1.0" encoding="UTF-8"?>
<LoginRequest>
    <Username>your_username</Username>
    <Password>your_password</Password>
</LoginRequest>
XML;

// 设置cURL选项，特别是针对POST请求
$args = array(
    CURLOPT_POST        =>  true,              // 明确指定为POST请求
    CURLOPT_POSTFIELDS  =>  $post_data_xml     // POST请求体数据
);

// 设置请求头，包括认证信息和内容类型
$headers = array(
    'xxxxxx-Username: your_api_username', // 替换为您的API用户名
    'xxxxxx-Password: your_api_password', // 替换为您的API密码
    'Content-Type: application/xml',      // 明确告知API发送的是XML数据
    'Accept: application/xml'             // 期望接收XML响应
);

// 执行cURL请求
$res = curl( $url, $args, $headers );

// 检查HTTP状态码
if( $res->info->http_code === 200 ){
    // 请求成功，处理XML响应
    echo "<h1>API响应成功 (HTTP Code: " . $res->info->http_code . ")</h1>";
    echo "<pre>" . htmlentities($res->response) . "</pre>"; // 打印原始响应

    // 尝试解析XML响应
    try {
        $xml = new SimpleXMLElement($res->response);
        echo "<h2>解析后的XML数据:</h2>";
        print_r($xml);
        // 进一步处理 $xml 对象，例如获取token
        // $token = (string)$xml->AuthInfo->token;
        // echo "<p>获取到的Token: " . $token . "</p>";
    } catch (Exception $e) {
        echo "<h2>XML解析失败:</h2>";
        echo "<p>" . $e->getMessage() . "</p>";
    }
} else {
    // 请求失败，打印详细调试信息以诊断问题
    echo "<h1>API请求失败 (HTTP Code: " . $res->info->http_code . ")</h1>";
    echo "<h2>cURL错误信息:</h2>";
    echo "<pre>" . $res->errors . "</pre>";
    echo "<h2>cURL详细调试信息 (Verbose Debug Info):</h2>";
    echo "<pre>" . htmlentities($res->verbose) . "</pre>";
    echo "<h2>cURL请求信息 (Info):</h2>";
    echo "<pre>" . print_r($res->info, true) . "</pre>";
    echo "<h2>API原始响应 (可能为HTML错误页面):</h2>";
    echo "<pre>" . htmlentities($res->response) . "</pre>";
}
?>

try {
    $xml = new SimpleXMLElement($res->response);
    // 现在您可以像访问对象属性一样访问XML元素
    $token = (string)$xml->AuthInfo->token;
    $statusId = (int)$xml->AuthInfo->AuthStatus->Id;
    $statusDescription = (string)$xml->AuthInfo->AuthStatus->Description;

    echo "Token: " . $token . "<br>";
    echo "Status ID: " . $statusId . "<br>";
    echo "Status Description: " . $statusDescription . "<br>";

} catch (Exception $e) {
    echo "XML解析错误: " . $e->getMessage();
}