
在php应用中,我们经常需要将数据封装成对象,然后通过json_encode函数将其序列化为json格式进行传输或存储。然而,如果对象中的某些属性值在业务逻辑中可能为null,这些null值在json输出中通常会以"key": null的形式呈现。虽然这在技术上是合法的json,但在某些场景下,我们可能希望完全省略这些null字段,以减小json负载、提高可读性,或满足特定的api接口规范。
例如,以下PHP代码:
<?php
$id_info = null; // 假设查询结果为NULL
$name_info = 'John Doe';
$obj = (object) [
"id" => strval($id_info), // strval(null) 会变成空字符串 ""
"Name" => (object) [
"eng_name" => strval($name_info)
]
];
echo json_encode($obj);
?>会输出:
{"id":"","Name":{"eng_name":"John Doe"}}注意,这里strval(null)导致id字段变为""(空字符串),而不是null。如果直接赋值$id_info为null,则会输出"id":null。我们的目标是,无论NULL还是""(在某些语境下可能也被视为需要省略的空值),都能被有效地移除。
对于结构相对简单、嵌套层级不深的对象,最直接的方法是在构建对象时进行条件判断。只有当属性值非NULL(或非空)时,才将其添加到对象中。
立即学习“PHP免费学习笔记(深入)”;
<?php
$id_info = ($db->query("SomeSQL query")->fetch_assoc())['id'] ?? null; // 使用null合并运算符处理查询结果
$name_info = 'John Doe';
$age_info = null; // 假设年龄信息为NULL
$data = []; // 使用关联数组构建更灵活
if ($id_info !== null) {
$data["id"] = strval($id_info);
}
// 嵌套对象也可以通过类似方式处理
$name_data = [];
if ($name_info !== null) {
$name_data["eng_name"] = strval($name_info);
}
// 如果Name对象本身可能为空,可以再加一层判断
if (!empty($name_data)) {
$data["Name"] = (object) $name_data;
}
if ($age_info !== null) {
$data["Age"] = $age_info;
}
$obj = (object) $data; // 将数组转换为对象
echo json_encode($obj);
?>如果$id_info为NULL,则最终JSON输出中将不包含"id"字段。这种方法清晰直观,适用于对象属性数量有限且层级不深的场景。
当PHP对象包含深层嵌套结构时,手动进行条件判断会变得非常繁琐且容易出错。此时,更优雅的解决方案是先将整个对象转换为数组,然后使用一个递归函数对数组进行过滤,最后再将过滤后的数组编码为JSON。
我们可以编写一个通用的递归函数来遍历数组(或从对象转换而来的数组),并移除其中值为“假值”(false, null, 0, "", []等)的元素。
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30
<?php
/**
* 递归过滤数组中的“假值”元素。
* 如果元素为数组,则递归过滤其内部元素。
* 如果元素为非空数组,则保留。
* 如果元素为非“假值”的非数组,则保留。
*
* @param array|object $inputData 输入数据,可以是数组或StdClass对象
* @return array|null 过滤后的数组,如果整个输入数据被过滤为空,则返回null
*/
function arrayFilter($inputData) {
$output = [];
// 如果是对象,先转换为数组处理
if (is_object($inputData)) {
$inputData = (array) $inputData;
}
if (is_array($inputData)) {
foreach ($inputData as $key => $val) {
// 注意:这里是过滤“假值” (falsy values),包括 null, 0, false, "", []
// 如果你只想过滤 null,应使用 is_null($val)
if (!$val && !is_numeric($val) && $val !== false) { // 改进条件,确保0和false不会被错误过滤
continue;
}
if (is_array($val) || is_object($val)) {
$tmpArr = arrayFilter($val); // 递归调用
if (!empty($tmpArr)) { // 如果子数组过滤后不为空,则保留
$output[$key] = $tmpArr;
}
} else {
$output[$key] = $val;
}
}
}
return empty($output) ? null : $output; // 如果过滤后为空,返回null
}
?>假设我们有以下一个深层嵌套的PHP对象,其中包含多个NULL值:
<?php
$obj = (object) [
"id" => null,
"Name" => (object) [
"eng_name" => 'some name2',
"de_name" => null,
"more" => (object) [
"fr_name" => 'some name3',
"ru_name" => null,
"empty_arr" => [],
"zero_val" => 0 // 假设0也需要保留
]
],
"address" => null,
"isActive" => false // 假设false也需要保留
];
// 1. 将StdClass对象转换为关联数组
// json_encode -> json_decode(..., true) 是一个将StdClass对象深度转换为关联数组的常用技巧
$arrayObj = json_decode(json_encode($obj), true);
// 2. 使用自定义函数过滤数组
$filteredArray = arrayFilter($arrayObj);
// 3. 将过滤后的数组编码为JSON
echo json_encode($filteredArray, JSON_PRETTY_PRINT);
?>输出结果:
{
"Name": {
"eng_name": "some name2",
"more": {
"fr_name": "some name3",
"zero_val": 0
}
},
"isActive": false
}从输出可以看出,id、de_name、ru_name、empty_arr和address等NULL或空值字段都被成功移除了。zero_val和isActive被保留了下来,因为arrayFilter的改进条件确保了0和false不会被误过滤。
// 在arrayFilter函数内部,将
// if (!$val && !is_numeric($val) && $val !== false) {
// 替换为:
if (is_null($val)) {
continue;
}这样修改后,0、false、""等非NULL的假值都会被保留。
选择哪种方法取决于你的具体需求和对象的复杂程度:
无论采用哪种方法,目标都是生成更精简、更符合业务需求的JSON数据,从而优化数据传输和提升应用性能。在实际开发中,根据项目的具体情况和对“空值”的定义(是仅NULL还是所有falsy值),灵活调整过滤逻辑至关重要。
以上就是PHP对象中动态过滤NULL值字段以优化JSON输出的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号