1. 问题背景：JSON输出中的NULL值
在php开发中，我们经常需要将php对象转换为json格式的数据，以便在api响应或数据交换中使用。然而，当php对象中的某些属性值为null时，默认的json_encode()函数会将这些null值原样输出到json中。例如：
{
"id": null,
"Name": {
"eng_name": "some name",
"de_name": null
}
}在许多场景下，我们希望JSON输出更加精简，即如果某个字段的值为NULL，则该字段不应该出现在JSON中。这不仅可以减少数据传输量，还能使JSON结构更清晰，符合某些API规范的要求。
2. 解决方案一：直接条件赋值（适用于简单对象）
对于结构相对简单，嵌套层级不深的对象，可以在构建对象时，通过条件判断来决定是否添加某个属性。
示例代码：
假设我们从数据库查询获取数据，并希望根据数据是否为NULL来构建对象。
立即学习“PHP免费学习笔记（深入）”；
<?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"
}注意事项：
- 这种方法直观且易于理解，适用于在构建对象阶段就能明确哪些字段可能为NULL的场景。
- 对于深度嵌套或字段数量较多的对象，手动进行条件判断会使代码变得冗长和复杂，难以维护。
3. 解决方案二：递归过滤函数（适用于复杂嵌套对象）
当对象结构复杂，包含多层嵌套，并且可能在任何层级出现NULL值时，手动条件判断变得不可行。此时，我们可以利用递归函数对整个对象（或其数组表示）进行过滤。
核心思路是：
- 将PHP对象转换为关联数组，这可以通过json_encode()和json_decode(..., true)组合实现，确保所有嵌套的stdClass对象也被转换为数组。
- 编写一个递归函数，遍历数组的每个元素。
- 如果元素值为NULL，则跳过该元素。
- 如果元素值为数组，则递归调用自身进行过滤。
- 将过滤后的结果重新构建为数组，最终编码为JSON。
自定义递归过滤函数：
<?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"
}
}注意事项：
- json_decode(json_encode($obj), true)是处理复杂PHP对象转换为纯关联数组的关键步骤，它能确保所有stdClass对象也被正确转换为数组，从而方便递归处理。
- filterArrayNullRecursive函数不仅移除了NULL值，还会移除过滤后变为空的嵌套数组（或对象）。
- 在filterArrayNullRecursive中，当处理is_object($value)分支时，我们将其转换为数组过滤后再转回对象。如果最终目标只是JSON输出，那么直接保留过滤后的数组也是可以的，因为json_encode会正确处理数组。
- 对于非常庞大和深层嵌套的对象，频繁的json_encode/json_decode操作可能会带来一定的性能开销。在性能敏感的场景下，可以考虑直接在构建对象时使用条件赋值，或在PHP 7.4+中使用array_filter结合JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE等选项，并对NULL值进行特殊处理（虽然json_encode本身没有直接跳过NULL的选项）。
4. 总结
在PHP中处理JSON输出时，根据具体需求选择合适的NULL值处理策略至关重要。
- 对于结构简单、字段数量有限的对象，直接在对象构建阶段进行条件赋值是最直接有效的方法。
- 对于结构复杂、深度嵌套且NULL值可能散布在各处的对象，通过将对象转换为数组，然后使用自定义递归过滤函数是更健壮和可维护的解决方案。这种方法虽然涉及json_encode/json_decode的转换开销，但能极大地简化代码逻辑，确保输出的JSON数据干净、规范。
选择哪种方法取决于项目的具体要求、性能考虑以及代码的复杂性。通过这些技巧，您可以更好地控制JSON输出，提升API响应的质量。
