本教程旨在解决将Python FedEx追踪脚本转换为PHP时遇到的常见问题，特别是关于POST请求体格式的正确处理。通过分析Python requests库与PHP Requests库在发送表单数据和JSON数据时的差异，本文将详细指导如何正确构建请求参数，避免“UNSUPPORTED.ACTION”错误，从而成功实现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.1Content-Type: application/x-www-form-urlencodeddata=%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。例如：
'application/json'];$data = [ 'data' => [ /* ... 完整的请求结构 ... */ ], 'action' => 'trackpackages', 'locale' => 'en_US', 'format' => 'json', 'version' => 99];$response = Requests::post($url, $headers, json_encode($data));// ...?>
这种做法会导致整个请求体被发送为一个单一的JSON对象，例如：
立即学习“PHP免费学习笔记（深入）”；
{ "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代码示例：
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);// 打印响应内容，通常需要进一步解析JSONprint_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);// }?>
代码解析：
$headers = [];: 移除了’Content-Type’ => ‘application/json’头。当您向Requests::post()方法传递一个关联数组作为请求体时，它会默认将其编码为application/x-www-form-urlencoded，并自动设置正确的Content-Type头。“data” => json_encode([…]): 这是最关键的改动。我们不再对整个$data数组进行json_encode，而是只对data键对应的值（即TrackPackagesRequest的完整结构）进行json_encode。这样，外部的$data数组仍然可以被Requests库编码为表单数据，而内部的data字段则包含正确的JSON字符串。$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客户端库的细节是多么重要。
以上就是Python FedEx追踪脚本PHP转换：正确处理POST请求体格式的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1292884.html
微信扫一扫 
支付宝扫一扫 
