PHP cURL POST请求REST API XML响应获取指南

<?php

/**
 * 发送cURL请求的封装函数
 *
 * @param string|null $url 请求的URL
 * @param array|null $options cURL选项数组，用于覆盖默认设置
 * @param array|null $headers HTTP请求头数组
 * @return object 包含响应、信息、错误和详细调试信息的对象
 */
function curl( $url=NULL, $options=NULL, $headers=false ){
    // 请从 https://curl.haxx.se/docs/caextract.html 下载 cacert.pem
    // 并将其保存到可读的路径，然后修改 $cacert 变量
    $cacert = 'D:/Adri/PHP/MoW/famac/cacert.pem'; // 示例路径，请根据实际情况修改

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

    $res = (object)array(
        'response'  =>  NULL,
        'info'      =>  (object)array( 'http_code' => 100 ), // 默认HTTP状态码
        'headers'   =>  NULL, // 响应头（如果CURLOPT_HEADER为true）
        'errors'    =>  NULL,
        'verbose'   =>  NULL // 详细调试信息
    );

    if( is_null( $url ) ) return $res;

    // 避免在cURL请求期间锁定session，影响并发
    if (session_status() == PHP_SESSION_ACTIVE) {
        session_write_close();
    }

    // 初始化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, dirname($cacert) ); // 指定CA证书目录
    }

    // 定义标准cURL选项
    curl_setopt( $curl, CURLOPT_URL, trim( $url ) );
    curl_setopt( $curl, CURLOPT_AUTOREFERER, true );       // 自动设置Referer
    curl_setopt( $curl, CURLOPT_FOLLOWLOCATION, true );    // 跟踪重定向
    curl_setopt( $curl, CURLOPT_FAILONERROR, false );      // 不将HTTP错误码视为cURL错误
    curl_setopt( $curl, CURLOPT_HEADER, false );           // 不在响应中包含头信息
    curl_setopt( $curl, CURLINFO_HEADER_OUT, true );       // 在cURL信息中包含请求头
    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' );
    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 );
    }

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

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

    // 获取详细调试信息
    rewind( $vbh ); // 将文件指针重置到开头
    $res->verbose   = stream_get_contents( $vbh );
    fclose( $vbh );

    curl_close( $curl );
    return $res;
}

<?php
// 假设上面的 curl 函数已经定义

$url = 'https://your-api-endpoint.com/api/login'; // 替换为你的API登录地址
$xml_data = '<AuthRequest><Username>your_username</Username><Password>your_password</Password></AuthRequest>'; // 替换为你的实际XML请求体

$args = array(
    CURLOPT_POST        =>  true,                   // 明确指定为POST请求
    CURLOPT_POSTFIELDS  =>  $xml_data               // 发送XML数据作为请求体
);

$headers = array(
    'xxxxxx-Username: your_api_username', // 替换为实际的自定义认证头
    'xxxxxx-Password: your_api_password', // 替换为实际的自定义认证头
    'Content-Type: application/xml'       // 明确告知服务器发送的是XML格式数据
);

$res = curl( $url, $args, $headers );

// --- 解析响应与故障排除 ---
if( $res->info->http_code == 200 ){
    // 成功接收到XML响应
    echo "<h1>成功获取XML响应：</h1>";
    echo "<pre>" . htmlspecialchars($res->response) . "</pre>"; // 打印原始XML

    try {
        // 使用SimpleXMLElement解析XML响应
        $xml = new SimpleXMLElement($res->response);
        // 示例：从XML中提取token或其他信息
        if (isset($xml->AuthInfo->token)) {
            echo "<p>Token: " . $xml->AuthInfo->token . "</p>";
        }
        if (isset($xml->AuthInfo->AuthStatus->Description)) {
            echo "<p>认证状态描述: " . $xml->AuthInfo->AuthStatus->Description . "</p>";
        }
    } catch (Exception $e) {
        echo "<p style='color: red;'>解析XML失败: " . $e->getMessage() . "</p>";
    }
} else {
    // 请求失败或服务器返回非200状态码
    echo "<h1>请求失败或错误！HTTP状态码: " . $res->info->http_code . "</h1>";

    echo "<h2>详细调试信息 (Verbose Debug Info)：</h2>";
    echo "<pre>" . htmlspecialchars($res->verbose) . "</pre>";

    echo "<h2>cURL请求信息 (cURL Info)：</h2>";
    echo "<pre>" . print_r($res->info, true) . "</pre>";

    if ($res->errors) {
        echo "<h2>cURL错误 (cURL Errors)：</h2>";
        echo "<pre>" . htmlspecialchars($res->errors) . "</pre>";
    }
}