Laravel怎么实现模型查询结果转JSON时忽略空值_Laravelfilter掉null字段【说明】

夜宇小哥_4171

夜宇小哥_4171

2026-04-20

826人浏览

原创

应重写模型的 toarray() 方法,遍历并 unset 值为 null 的字段,保留 0、false、空字符串等有效值,确保关联模型也做同样处理。

laravel怎么实现模型查询结果转json时忽略空值_laravelfilter掉null字段【说明】

模型序列化时怎么跳过 null 字段

默认情况下,Laravel 的 Eloquent 模型转 JSON(比如用 toJson() 或 API 返回响应)会把值为 null 的字段也输出为 "field": null。这不是 bug,是设计行为——但很多前端或接口规范要求“没值就不出现”,得手动干预。

最直接的方式是在模型里重写 toArray(),再让 JSON 序列化基于它。不要动 jsonSerialize(),它底层仍调用 toArray(),改这里更统一。

  • 在模型中添加 protected $casts = ['field' => 'string'] 不影响 null 输出,只管类型转换
  • 别用 appends + 访问器模拟“条件字段”,那只是加字段,不删字段
  • 如果字段是数据库里允许为 NULL 的列,且你不想改 schema,那就必须在序列化层过滤

Laravel 9+ 推荐:用 hidden + makeHidden() 动态处理?不推荐

hidden 是静态白名单/黑名单,不能按值动态决定是否隐藏。比如你想“当 middle_name 为 null 时才不输出”,hidden 做不到——它只认字段名,不看值。

有人试过在 toArray() 里用 unset(),但要注意:Eloquent 的 toArray() 返回的是副本数组,直接 unset 安全;但如果用了 append() 或访问器,得先调用父方法拿到完整数组再过滤。

  • 错误写法:return $this->attributes; —— 这是原始属性,含未转换的日期、布尔等,JSON 会出错
  • 正确起点:$array = parent::toArray();
  • 过滤示例:array_filter($array, fn($v) => $v !== null); —— 注意这会删掉 0、false、空字符串,太激进
  • 稳妥写法:遍历 + 显式判断 === null

安全过滤 null 的 toArray() 实现

在模型里覆盖 toArray(),只剔除明确为 null 的字段,保留 0、false、'' 等有效值:

chartjs-reporter
chartjs-reporter

此技能用于在用户需要将结构化数据(查询结果、CSV 摘要、JSON 记录或 Python 字典/列表)转换为独立的 HTML 页面时使用。

下载
public function toArray()
{
    $array = parent::toArray();
    foreach ($array as $key => $value) {
        if ($value === null) {
            unset($array[$key]);
        }
    }
    return $array;
}

这个逻辑简单、可预测,且不影响关系数据(toArray() 已递归处理关联模型)。如果你有深层嵌套关系并也要过滤,就得在关联模型里同样覆盖 toArray()。

  • 别在 toJson() 里做过滤——它只是包装了 json_encode($this->toArray())
  • 如果用了 Resource 类(如 UserResource),优先在 Resource 的 toArray() 里过滤,比改模型更灵活
  • 注意:修改 toArray() 后,firstOrCreate()、update() 等写操作不受影响,只影响读出的结构

API 响应层统一处理(适合多模型场景)

如果多个模型都要过滤 null,又不想每个都重写 toArray(),可以在响应构造时统一后处理。例如在控制器或 API 资源集合里:

return response()->json(array_filter(
    $user->toArray(),
    fn($v) => $v !== null
));

但注意:这只能处理顶层字段,不会递归进 relations 数组。如果返回的是 Collection,要先 map() 再 array_filter。

  • 用 Collection::map() 处理列表时,记得最后调用 values() 重置键,否则 JSON 会变成对象而非数组
  • 这种写法绕过了模型控制,调试时容易漏掉某处没加过滤
  • 性能上几乎无差异,PHP 数组遍历 null 过滤成本极低

真正容易被忽略的是关系字段里的 null:比如 user->profile 是 null,但默认序列化仍会输出 "profile": null。这时候光过滤模型自身字段没用,得确保关联模型也实现了同样的 toArray() 逻辑,或者用 with() 前确认关联存在。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

laravel js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

857

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

835

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2488

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

4161

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

5990

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

3956

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

7449

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1436

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

215

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 208人学习

Composer手册
Composer手册

共0课时 | 0人学习