PythonFedEx追踪脚本转PHP：POST请求处理方法

本文针对将Python FedEx追踪脚本迁移至PHP时，遇到的POST请求体处理难题，提供详细解决方案。重点剖析Python requests库与PHP Requests库在处理POST请求时，对于`application/x-www-form-urlencoded`和`application/json`两种数据格式的差异。通过避免直接将整个请求参数JSON编码，而是巧妙地将`data`字段的值进行JSON序列化，模拟Python脚本的请求行为，成功解决了“UNSUPPORTED.ACTION”错误。本文提供修正后的PHP代码示例，并强调API文档的重要性，以及使用调试工具检查请求内容的必要性，助力开发者顺利实现FedEx包裹追踪功能。

理解Python与PHP的POST请求体差异

在将Python脚本转换为PHP时，尤其涉及与外部API交互的POST请求，一个常见的陷阱是对请求体（Request Body）格式的误解。Python的requests库在处理data参数时，默认将其作为application/x-www-form-urlencoded类型发送，即使data参数的值本身是一个JSON字符串。而如果使用json参数，则会将整个请求体序列化为JSON，并设置Content-Type: application/json。

原始Python脚本通过requests.post('...', data={...})发送请求。关键在于，data字典中的'data'键对应的值是通过json.dumps()函数序列化后的JSON字符串。这意味着整个POST请求的结构是：

POST /trackingCal/track HTTP/1.1
Content-Type: application/x-www-form-urlencoded

data=%7B%22TrackPackagesRequest%22%3A%7B...%7D%7D&action=trackpackages&locale=en_US&format=json&version=99

可以看到，外层是一个URL编码的表单数据，其中一个字段data的值是经过JSON编码的字符串。

错误的PHP转换尝试及其原因

初次尝试将Python逻辑转换为PHP时，开发者可能会倾向于将整个请求参数数组进行JSON编码，并设置Content-Type: application/json。例如：

<?php
// ...
$headers = ['Content-Type' => 'application/json'];
$data = [
    'data' => [ /* ... 完整的请求结构 ... */ ],
    'action' => 'trackpackages',
    'locale' => 'en_US',
    'format' => 'json',
    'version' => 99
];
$response = Requests::post($url, $headers, json_encode($data));
// ...
?>

这种做法会导致整个请求体被发送为一个单一的JSON对象，例如：

{
    "data": {
        "TrackPackagesRequest": { /* ... */ }
    },
    "action": "trackpackages",
    "locale": "en_US",
    "format": "json",
    "version": 99
}

这与FedEx API所期望的application/x-www-form-urlencoded格式（其中data字段的值是JSON字符串）不符。因此，API会返回{"CALError": {"code":"UNSUPPORTED.ACTION", "message":" is not a supported action", ...}}错误，表明它无法解析这种格式的请求。

正确的PHP实现方式

要正确地将Python脚本转换为PHP，我们需要模拟Python requests库的行为：将外层参数作为application/x-www-form-urlencoded发送，但其中data字段的值需要是JSON编码的字符串。

PHP的Requests库（或cURL）在发送POST请求时，如果第三个参数是一个关联数组，它会默认将其作为application/x-www-form-urlencoded类型发送。因此，我们只需要确保data数组中的data键对应的值是经过json_encode()处理的字符串即可。

以下是修正后的PHP代码示例：

<?php

// 引入Composer自动加载文件，确保Requests库可用
$dir = __DIR__;
include $dir .'/vendor/autoload.php';

// 示例追踪号
$tracking_number = '123456789'; // 请替换为实际的追踪号

// FedEx追踪API的URL
$url = 'https://www.fedex.com/trackingCal/track';

// 请求头：对于application/x-www-form-urlencoded，通常不需要显式设置Content-Type，
// Requests库会根据$data参数的类型自动处理。
$headers = []; 

// 构建POST请求的数据体
$data = [
    // 'data' 字段的值必须是JSON编码的字符串
    "data" => json_encode([
        "TrackPackagesRequest" => [
            "appType" => "wtrk",
            "uniqueKey" => "",
            "processingParameters" => [
                "anonymousTransaction" => true,
                "clientId" => "WTRK",
                "returnDetailedErrors" => true,
                "returnLocalizedDateTime" => false
            ],
            "trackingInfoList" => [[
                "trackNumberInfo" => [
                    "trackingNumber" => $tracking_number,
                    "trackingQualifier" => "",
                    "trackingCarrier" => ""
                ]
            ]]
        ]
    ]),
    "action" => "trackpackages",
    "locale" => "en_US",
    "format" => "json",
    "version" => 99
];

// 发送POST请求
// Requests::post() 方法会将 $data 数组自动编码为 application/x-www-form-urlencoded
$response = Requests::post($url, $headers, $data);

// 打印响应内容，通常需要进一步解析JSON
print_r($response->body); // 访问响应体内容
// 示例：解析JSON响应
// $decoded_response = json_decode($response->body, true);
// if (isset($decoded_response['TrackPackagesResponse']['packageList'][0])) {
//     $fedex_status  = $decoded_response['TrackPackagesResponse']['packageList'][0]['keyStatus'];
//     $fedex_details = $decoded_response['TrackPackagesResponse']['packageList'][0]['statusWithDetails'];
//     $delivery_date = $decoded_response['TrackPackagesResponse']['packageList'][0]['displayActDeliveryDt'];
//     $delivery_time = $decoded_response['TrackPackagesResponse']['packageList'][0]['displayActDeliveryTm'];
//     echo "FedEx Status: " . $fedex_status . "\n";
//     echo "Details: " . $fedex_details . "\n";
//     echo "Delivery Date: " . $delivery_date . "\n";
//     echo "Delivery Time: " . $delivery_time . "\n";
// } else {
//     echo "Error or no tracking information found.\n";
//     print_r($decoded_response);
// }

?>

代码解析：

1. $headers = [];: 移除了'Content-Type' => 'application/json'头。当您向Requests::post()方法传递一个关联数组作为请求体时，它会默认将其编码为application/x-www-form-urlencoded，并自动设置正确的Content-Type头。
2. "data" => json_encode([...]): 这是最关键的改动。我们不再对整个$data数组进行json_encode，而是只对data键对应的值（即TrackPackagesRequest的完整结构）进行json_encode。这样，外部的$data数组仍然可以被Requests库编码为表单数据，而内部的data字段则包含正确的JSON字符串。
3. $response = Requests::post($url, $headers, $data);: Requests库会负责将$data数组转换为key1=value1&key2=value2的形式，并自动设置Content-Type: application/x-www-form-urlencoded。

注意事项与总结

• API文档是金标准： 在进行API集成或跨语言转换时，始终优先查阅API的官方文档，了解其期望的请求体格式（application/x-www-form-urlencoded、application/json、multipart/form-data等）和Content-Type头。
• 库行为差异： 不同的HTTP客户端库在处理请求体参数时可能有不同的默认行为。Python的requests库区分data和json参数，而PHP的Requests库则主要通过第三个参数的类型来判断。
• 调试是关键： 当遇到API错误时，仔细检查请求发送的实际内容（使用代理工具如Wireshark、Fiddler或Burp Suite，或库自带的调试功能）与API期望的格式是否一致，是解决问题的最有效方法。
• 嵌套编码： 本例展示了一种嵌套编码的场景：外层是URL编码的表单数据，内层某个字段的值是JSON编码的字符串。理解这种结构对于处理复杂API至关重要。

通过以上修正，PHP脚本将能够以与原始Python脚本完全相同的请求格式与FedEx API进行交互，从而成功获取包裹追踪信息。这个案例也强调了在跨语言移植API调用逻辑时，深入理解HTTP请求协议和各语言HTTP客户端库的细节是多么重要。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。