在使用 PHP 向 REST API 发送 POST 请求时，经常会遇到需要处理复杂的数据结构，特别是当 API 期望的数据格式是混合了数组和对象时。一个常见的错误是未能正确构建嵌套的数组结构，导致 API 返回验证错误。本文将重点介绍如何正确地使用 PHP 构建包含混合数组和对象的 JSON 数据，并以 addresses 字段中的 billing 信息为例进行详细说明。
理解问题：addresses 字段的结构
在示例中，API 期望的 addresses 字段的 billing 属性是一个包含对象的数组。这意味着即使只有一个账单地址，也需要将其放入一个数组中。错误的做法是直接将账单地址对象赋值给 billing 属性，导致 API 无法正确解析。
正确构建 PHP 数组
要解决这个问题，需要确保 billing 属性的值是一个数组，即使该数组只包含一个元素。以下是修改后的 PHP 代码示例：
null,
"street" => "aaa",
"zipCode" => "12345",
"city" => "Berlin",
"country" => "DE",
];
$billingAddr = array(
"supplement" => $billingAddress["streetDetails"],
"street" => $billingAddress["street"],
"zip" => $billingAddress["zipCode"],
"city" => $billingAddress["city"],
"countryCode" => $billingAddress["country"],
);
$params = [
"version" => 0,
"roles" => null, // 替换为你的roles数据
"person" => null, // 替换为你的person数据
"emailAddresses" => null, // 替换为你的emailAddresses数据
"addresses" => [
"billing" => [$billingAddr] // 将 $billingAddr 放入数组中
]
];
echo json_encode($params, JSON_PRETTY_PRINT);
?>在这个示例中，$billingAddr 包含了账单地址的详细信息。关键在于 addresses 数组的构建方式："addresses" => [ "billing" => [$billingAddr] ]。 通过将 $billingAddr 放入一个数组 [$billingAddr] 中，我们确保了 billing 属性的值是一个包含一个元素的数组，这符合 API 期望的格式。
立即学习“PHP免费学习笔记（深入）”；
验证 JSON 结构
为了验证生成的 JSON 结构是否正确，可以使用 json_encode 函数将其转换为 JSON 字符串，并使用 JSON_PRETTY_PRINT 选项使其更易于阅读。
echo json_encode($params, JSON_PRETTY_PRINT);
输出的 JSON 应该类似于：
{
"version": 0,
"roles": null,
"person": null,
"emailAddresses": null,
"addresses": {
"billing": [
{
"supplement": null,
"street": "aaa",
"zip": "12345",
"city": "Berlin",
"countryCode": "DE"
}
]
}
}注意 billing 属性的值是一个数组，其中包含一个包含账单地址信息的对象。
注意事项
- 数据类型匹配： 确保 PHP 变量的数据类型与 API 期望的数据类型匹配。例如，如果 API 期望一个整数，确保 PHP 变量也是一个整数。
- 空值处理： 根据 API 的要求，正确处理空值。有些 API 可能要求使用 null，而有些 API 可能要求使用空字符串 ""。
- 字符编码： 确保 PHP 脚本的字符编码与 API 期望的字符编码一致，通常是 UTF-8。
- 错误处理： 在使用 json_encode 函数时，检查返回值是否为 false，以确保 JSON 编码成功。如果编码失败，可以使用 json_last_error 函数获取错误代码。
总结
正确处理 PHP 中混合数组和对象的关键在于理解 API 期望的数据结构，并使用正确的 PHP 语法来构建数组。通过将 $billingAddr 放入数组 [$billingAddr] 中，可以确保 billing 属性的值是一个包含对象的数组，从而避免因数据格式验证失败导致的请求错误。 始终验证生成的 JSON 结构，并注意数据类型匹配、空值处理和字符编码等细节，以确保 API 请求能够成功发送。
