
在php应用程序中,我们经常需要将业务数据封装成对象,然后通过json_encode()函数将其序列化为json字符串,供前端或其他服务消费。然而,当对象中的某些属性值为null时,json_encode()默认会将这些null值字段一并输出到json中。例如:
<?php
$id_info = null; // 假设从数据库查询得到null
$name_info = "John Doe";
$obj = (object) [
"id" => $id_info,
"Name" => (object) [
"eng_name" => $name_info
]
];
echo json_encode($obj, JSON_PRETTY_PRINT);
?>上述代码的输出将是:
{
"id": null,
"Name": {
"eng_name": "John Doe"
}
}可以看到,即使id为NULL,它仍然作为"id": null出现在JSON中。在某些场景下,我们希望这些NULL字段不被输出,以使JSON数据更精简。
对于结构相对简单、层级不深的PHP对象,最直接的方法是在构建对象时,对每个属性进行条件判断。只有当属性值非NULL时,才将其添加到对象中。
<?php
$db = new mysqli("localhost", "user", "password", "database"); // 示例数据库连接
// 假设 $id_info 从数据库查询,可能为 NULL
$result = $db->query("SELECT id FROM some_table WHERE condition LIMIT 1");
$id_info = $result ? ($result->fetch_assoc()['id'] ?? null) : null;
$name_info = "John Doe"; // 假设 $name_info 总是存在
// 构建对象时进行条件判断
$obj = (object) [];
if ($id_info !== null) {
$obj->id = strval($id_info);
}
// 嵌套对象也需要类似处理
$nameObj = (object) [];
if ($name_info !== null) {
$nameObj->eng_name = strval($name_info);
}
if (!empty((array)$nameObj)) { // 只有当nameObj不为空时才添加
$obj->Name = $nameObj;
}
echo json_encode($obj, JSON_PRETTY_PRINT);
?>通过这种方式,如果$id_info为NULL,则id属性不会被添加到$obj中,最终的JSON输出将不包含"id": null。
立即学习“PHP免费学习笔记(深入)”;
当PHP对象结构复杂,包含多层嵌套时,手动进行条件判断会变得非常繁琐且容易出错。此时,更优雅的解决方案是利用递归函数对整个对象(或转换为数组后)进行深度过滤。
这种方法的核心步骤是:
将stdClass对象转换为关联数组的常用技巧是先json_encode再json_decode:
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30
$array_form = json_decode(json_encode($obj), true);
接下来,我们定义一个自定义的递归过滤函数:
这个函数能够深度遍历多维数组,并移除其中值为NULL的元素。
<?php
/**
* 递归过滤数组中的NULL值和空数组
*
* @param array $inputArr 输入数组
* @return array|null 过滤后的数组,如果过滤后为空则返回null
*/
function arrayFilter($inputArr) {
$output = []; // 初始化为空数组,而不是null
if (is_array($inputArr)) {
foreach ($inputArr as $key => $val) {
// 如果值为null,则跳过不添加到输出
if ($val === null) {
continue;
}
if (is_array($val)) {
// 如果是数组,则递归调用自身进行过滤
$tmpArr = arrayFilter($val);
// 如果递归过滤后的子数组不为空,则添加到输出
if ($tmpArr !== null && !empty($tmpArr)) { // 确保不是null且不是空数组
$output[$key] = $tmpArr;
}
} else {
// 非数组且非null的值直接添加到输出
$output[$key] = $val;
}
}
}
// 如果过滤后的输出数组为空,则返回null,否则返回过滤后的数组
return empty($output) ? null : $output;
}
// 示例:一个深度嵌套的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,
"empty_section" => (object)[] // 示例:空对象
]
],
"address" => null,
"contact" => (object)[] // 示例:空对象
];
// 1. 将stdClass对象转换为关联数组
$array_obj = json_decode(json_encode($obj), true);
// 2. 使用自定义函数进行过滤
$filtered_array = arrayFilter($array_obj);
// 3. 将过滤后的数组编码为JSON
echo json_encode($filtered_array, JSON_PRETTY_PRINT);
?>经过上述过滤处理后,echo json_encode($filtered_array, JSON_PRETTY_PRINT); 将生成以下JSON输出:
{
"Name": {
"eng_name": "some name2",
"more": {
"fr_name": "some name3"
}
}
}可以看到,所有值为NULL的字段(如id、de_name、ru_name、address),以及过滤后为空的嵌套对象(如empty_section和contact),都已从最终的JSON输出中移除,生成了更加简洁和符合预期的JSON结构。
在PHP中处理对象到JSON的序列化时,有效管理NULL值字段的输出是生成高质量JSON数据的关键。对于简单场景,可以在对象构建阶段通过条件判断直接控制;而对于复杂嵌套的对象结构,采用将对象转换为数组后,再通过自定义递归过滤函数进行深度处理的方法,能够提供更灵活、更强大的解决方案。理解并运用这些策略,将帮助开发者生成更精简、更符合业务需求的JSON数据。
以上就是PHP对象JSON序列化时NULL值字段的过滤策略的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号