ThinkPHP怎么实现模型字段分组输出_ThinkPHP返回结构按业务分类【教程】-ThinkPHP-PHP中文网

thinkphp模型不支持字段自动分组输出，所谓业务分组是手动通过visible()/hidden()/only()等方法控制字段可见性实现的，非框架内置能力。

thinkphp怎么实现模型字段分组输出_thinkphp返回结构按业务分类【教程】

ThinkPHP 的模型本身不支持字段分组输出，所谓“按业务分类返回结构”是手动控制字段可见性的结果，不是框架内置能力。

ThinkPHP 模型的序列化方法（如 toArray()）默认把所有已加载字段（包括关联、动态属性）一股脑吐出来，它没有“字段分组”概念。所谓“用户信息分组”“订单摘要分组”，其实是你主动筛选字段的逻辑，不是模型自动识别业务语义。

这是最常用也最可控的方式：在查询后、序列化前，显式声明要保留或排除哪些字段。它不改变模型结构，只影响当前输出。

visible() 优先级高于 hidden()；两者同时用时，visible() 列表为准
字段名必须是模型实际存在的属性名（不是数据库列名），比如 user_name 要写成 userName（若开启下划线转驼峰）
关联字段不能直接用 visible(['profile']) 控制，得在关联定义里单独设 visible，或用 with(['profile' => function ($q) { $q->visible(['avatar', 'bio']); }])

示例：

$user = User::find(123)->visible(['id', 'nickname', 'avatar'])->hidden(['password', 'salt']);

有人会在模型类顶部写 protected $visible = ['id', 'name'];，以为能一劳永逸——但这个设置全局生效，极易导致接口字段失控。

append() 只是往结果里加字段，它不改变原有字段结构，也不能把已有字段“挪进某个分组对象”。所谓“用户基础信息分组”，得靠你自己组装数组。

append(['full_name']) 会让结果多一个 full_name 字段，但它和平级的 id、email 并列，不会自动变成 { user: { id, email }, profile: { ... } }

真要结构化分组，得手写数组：

['user' => $user->only(['id', 'nickname']), 'profile' => $user->profile->only(['avatar', 'bio'])]

字段分组本质是视图层职责，不是模型该干的事。最容易被忽略的是：同一个模型在不同接口中字段需求完全不同，硬塞进模型配置只会让维护成本指数上升。每次加新接口，先想清楚“这里到底要哪几个字段”，再用 only() 或 visible() 显式写出来，比依赖任何“自动分组”机制都可靠。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！

ThinkPHP怎么实现模型字段分组输出_ThinkPHP返回结构按业务分类【教程】