PHP对象中NULL值处理与JSON输出优化指南

{
   "id": null,
   "Name": {
      "eng_name": "some name",
      "de_name": null
   }
}

<?php

// 模拟数据库查询结果
$id_info = null; // 假设id_info为NULL
$name_info = 'John Doe';
$country_info = 'USA';
$bio_info = null; // 假设bio_info为NULL

// 初始化一个空数组，用于构建对象属性
$objData = [];

// 条件判断，只有当id_info不为NULL时才添加
if ($id_info !== null) {
    $objData['id'] = strval($id_info);
}

// Name属性始终存在
$objData['Name'] = [
    'eng_name' => strval($name_info)
];

// 条件判断，只有当country_info不为NULL时才添加
if ($country_info !== null) {
    $objData['country'] = $country_info;
}

// 嵌套对象中的属性也可以进行条件判断
$objData['Details'] = [];
if ($bio_info !== null) {
    $objData['Details']['bio'] = $bio_info;
}
// 如果Details中没有任何有效属性，可以进一步判断是否添加Details
if (empty($objData['Details'])) {
    unset($objData['Details']);
}


// 将数组转换为PHP标准对象
$obj = (object) $objData;

// 将对象编码为JSON
echo json_encode($obj, JSON_PRETTY_PRINT);

?>

{
    "Name": {
        "eng_name": "John Doe"
    },
    "country": "USA"
}

<?php

/**
 * 递归过滤数组中所有NULL值和空数组（如果子数组过滤后为空）
 *
 * @param array $inputArray 待过滤的输入数组
 * @return array 过滤后的数组
 */
function filterArrayNullRecursive(array $inputArray): array {
    $outputArray = [];
    foreach ($inputArray as $key => $value) {
        // 如果值为NULL，则跳过此键值对
        if ($value === null) {
            continue;
        }

        // 如果值为数组，则递归调用自身进行过滤
        if (is_array($value)) {
            $filteredNested = filterArrayNullRecursive($value);
            // 只有当过滤后的子数组不为空时，才将其添加到结果中
            if (!empty($filteredNested)) {
                $outputArray[$key] = $filteredNested;
            }
        }
        // 如果值为对象（在json_decode(..., true)后，通常不会直接遇到stdClass对象，
        // 但如果输入本身就是混合的，此分支可以处理）
        elseif (is_object($value)) {
            // 将对象转换为数组进行递归过滤，然后可以根据需要再转回对象或直接保留数组
            $filteredNested = filterArrayNullRecursive((array) $value);
            if (!empty($filteredNested)) {
                // 这里选择将其转回对象，以保持原有的结构类型，但对于最终JSON输出，直接保留数组也是可以的
                $outputArray[$key] = (object) $filteredNested;
            }
        }
        // 其他非NULL、非数组的值直接添加
        else {
            $outputArray[$key] = $value;
        }
    }
    return $outputArray;
}

// 示例：一个深度嵌套的PHP对象
$obj = (object) [
    "id" => null,
    "Name" => (object) [
        "eng_name" => strval('some name2'),
        "de_name" => null,
        "more" => (object) [
            "fr_name" => strval('some name3'),
            "ru_name" => null,
            "extra" => (object) [
                "field1" => "value1",
                "field2" => null
            ]
        ],
        "empty_info" => null
    ],
    "address" => null,
    "contact" => (object) [
        "email" => "test@example.com",
        "phone" => null
    ],
    "preferences" => (object) [
        "theme" => null,
        "language" => null // 假设这个对象过滤后会变空
    ]
];

// 步骤1: 将PHP对象转换为关联数组（包括所有嵌套对象）
// json_encode将PHP对象转换为JSON字符串
// json_decode(..., true)将JSON字符串转换为PHP关联数组
$arrayRepresentation = json_decode(json_encode($obj), true);

// 步骤2: 使用自定义递归函数过滤数组中的NULL值
$filteredArray = filterArrayNullRecursive($arrayRepresentation);

// 步骤3: 将过滤后的数组编码为JSON
echo json_encode($filteredArray, JSON_PRETTY_PRINT);

?>

{
    "Name": {
        "eng_name": "some name2",
        "more": {
            "fr_name": "some name3",
            "extra": {
                "field1": "value1"
            }
        }
    },
    "contact": {
        "email": "test@example.com"
    }
}