PHP遍历JSON数据：API返回不同JSON格式的适配问询

云原生阿岚

2026-5-21

适配API返回的pets字段（数组/单个对象）的遍历方案

看起来你遇到了API返回格式不一致的问题——有时候pets是数组，有时候可能是单个对象（比如只有一只宠物时），直接用foreach遍历会报错对吧？我来给你几个靠谱的兼容方案：

方案1：统一将`pets`转为数组（对象模式）

在遍历前先检查pets的类型，如果是单个对象就把它包装成数组，这样不管API返回哪种格式，遍历逻辑都能统一：

// 示例API返回的两种情况
// $json = '{"owner": "Jane Doe", "pets": [{"color": "white", "type": "cat"}, {"color": "black", "type": "dog"}]}';
// $json = '{"owner": "John Doe", "pets": {"color": "brown", "type": "rabbit"}}';

$jsonObject = json_decode($json);

// 先处理pets字段：如果存在就取，不存在则设为空数组
$pets = isset($jsonObject->pets) ? $jsonObject->pets : [];
// 检查是否是数组，不是的话转成数组
if (!is_array($pets)) {
    $pets = [$pets];
}

// 正常遍历，额外加判断避免字段缺失报错
foreach($pets as $pet){
    $petType = isset($pet->type) ? $pet->type : 'Unknown';
    echo 'Pet type:'.$petType.'</br>';
}

方案2：用关联数组模式处理

如果你习惯用数组而不是对象，也可以用json_decode的第二个参数（设为true）转成关联数组，逻辑类似：

$jsonArray = json_decode($json, true);

$pets = isset($jsonArray['pets']) ? $jsonArray['pets'] : [];
if (!is_array($pets)) {
    $pets = [$pets];
}

foreach($pets as $pet){
    $petType = isset($pet['type']) ? $pet['type'] : 'Unknown';
    echo 'Pet type:'.$petType.'</br>';
}