当前位置:

首页 > 编程开发 > ThinkPHP中Model的append属性_追加计算字段到输出数组【技巧】

ThinkPHP中Model的append属性_追加计算字段到输出数组【技巧】

ThinkPHP 的 `$append` 属性,说白了就是一个开关——它用来配合访问器(获取器)触发计算逻辑。但有个前提:这个开关只在模型实例被正确序列化时才会生效,比如调用 `toArray()`、`toJson()` 或者 API 自动转换。而且,每个你追加的字段,都必须有一个对应命名的 `ge

本文目录
    ThinkPHP 的 `$append` 属性,说白了就是一个开关——它用来配合访问器(获取器)触发计算逻辑。但有个前提:这个开关只在模型实例被正确序列化时才会生效,比如调用 `toArray()`、`toJson()` 或者 API 自动转换。而且,每个你追加的字段,都必须有一个对应命名的 `getXXXAttr()` 方法等着它,否则就是白搭。

    ThinkPHP中Model的append属性_追加计算字段到输出数组【技巧】

    很多新手以为 `$append` 里写个字段名就能自动出值,其实远没那么简单。它本质上是一个触发机制,让你能在模型输出时动态计算一些额外信息。但坑也不少,我们来逐一拆解。

    字段名和获取器必须严格配对

    比如你想追加一个 `full_name` 字段,那就得在模型里做两件事:

    • 在 `protected $append = ['full_name'];` 中声明字段名(注意是字符串,小写加下划线)
    • 同时提供方法 `public function getFullNameAttr($value, $data)`(驼峰命名,`Attr` 结尾)
    • 方法内部建议优先读取 `$data['first_name']` 和 `$data['last_name']`,而不是直接 `$this->first_name`——后者可能触发其他获取器,造成不必要的性能损耗
    • 返回值必须明确,哪怕只是空字符串:`return $data['first_name'] . ' ' . ($data['last_name'] ?? '');`

    配对错误是最常见的翻车点,字段名和方法名差一个字母都不行。

    注意数据来源是否走模型流程

    直接用 `Db::table()->select()` 或 `query()->execute()` 得到的是原生数组,压根不会触发任何获取器,`$append` 自然毫无效果。所以要注意:

    • 必须用模型查询:`UserModel::select()` 或 `UserModel::find(1)` 才行
    • 集合(Collection)默认不会自动执行 `$append`,需要显式调用 `$list->toArray()`
    • 分页对象(如 `Paginator`)也得对 `$list->items()` 或整个结果调用 `toArray()`,否则追加字段不会出现

    避免性能陷阱:别在获取器里查库或发请求

    每个追加字段都会在每条记录的 `toArray()` 过程中单独执行一次获取器。假设有 100 条数据,你又加了 3 个 `$append` 字段——那就意味着 300 次函数调用。如果在获取器里再搞个数据库查询,后果可想而知。

    • 绝对禁止在 `getXXXAttr()` 里写 `User::find()`、`Db::name()->where()->value()` 等数据库操作
    • 如果依赖关联数据,必须提前用 `with('profile')` 预加载,然后在获取器里通过 `$this->profile?->title` 来获取
    • 时间格式化、字符串拼接、状态映射这类纯计算逻辑是安全的,可以放心用

    静态属性 vs 实例方法:用对场景才不丢字段

    `protected $append = [...]` 是全局默认设置,所有 `toArray()` 调用都会生效。而 `$model->append([...])` 是单次覆盖,会清空之前所有追加项。所以:

    • 通用字段(比如 `create_time_text`)适合写在模型静态属性里,一劳永逸
    • 接口级临时字段(比如仅详情页需要的 `is_fa vorited`)应该用实例方法:`$user->append(['is_fa vorited'])->toArray()`
    • 想叠加字段?得手动合并:`$user->append(array_merge($user->getAppend(), ['new_field']))`

    搞清楚这些,`$append` 才能真正帮你写出干净、高效的代码。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    特斯拉中国推出夏季专属权益:购Model 3/Y汽车享5年0息
    特斯拉中国推出夏季专属权益:购Model 3/Y汽车享5年0息

    特斯拉中国夏季购车权益:Model3/Y可享5年0息或0.99%低息贷款,首付55,900元起,月供约2193元,叠加8000元保险补贴;选装车漆减8000元,充电套餐1299元享2300度电。

    外媒:三年车龄Model 3租赁车电池健康度低于预期,频繁快充或加速损耗
    外媒:三年车龄Model 3租赁车电池健康度低于预期,频繁快充或加速损耗

    一辆行驶2.6万英里、服役三年的租赁版Model3,实测电池健康度90%,低于App估算值。频繁快充与高强度使用是加速损耗主因,三年衰减约10%,建议合理控制充电习惯。

    特斯拉46天拆除Model S/X产线,为Optimus机器人量产铺路
    特斯拉46天拆除Model S/X产线,为Optimus机器人量产铺路

    特斯拉46天拆除弗里蒙特工厂ModelS/X产线,两款旗舰车型停产,为Optimus人形机器人腾出空间。新产线目标年产能100万台。OptimusGen3已小规模试产,7月底大规模量产。

    马斯克宣布开放Model S、Model X设计资料与软件
    马斯克宣布开放Model S、Model X设计资料与软件

    特斯拉副总裁陶琳宣布,马斯克决定开放ModelS和ModelX的设计资料与软件。此举延续2014年起开放专利、超级充电网络及初代Roadster资料的开源传统,旨在推动电动车技术共享,促进产业协同发展。

    SpringMVC的@ModelAttribute注解是什么?作用及使用场景介绍
    SpringMVC的@ModelAttribute注解是什么?作用及使用场景介绍

    1.用在方法的参数上 当你在方法参数上看到@ModelAttribute时,它做的事情其实很直接:把客户端传过来的参数,按照参数名自动注入到指定的对象中。 不仅如此,这个对象还会被自动添加到ModelMap中,后续视图可以直接使用。 姓名: 生日: @RequestMapping(value="/r

    特斯拉海外为Model S/3/X/Y推送2026年夏季软件更新
    特斯拉海外为Model S/3/X/Y推送2026年夏季软件更新

    特斯拉海外推送2026年夏季软件更新,车载浏览器可直接调用车内摄像头和麦克风,支持谷歌Meet、微软Teams等网页视频会议,画面自动调整使驾驶员居中,但仅限搭载AMDRyzen芯片的车型,带来便捷的在线会议体验。

    特斯拉停产Model S与X后开源设计软件 惠及车主并促行业技术进步
    特斯拉停产Model S与X后开源设计软件 惠及车主并促行业技术进步

    特斯拉最近放了个大招——把Model S和Model X的设计图纸和软件系统,全部开源了。这事儿在电动车圈子里掀起了不小的波澜,毕竟这两款车型已经在今年第二季度正式停产,把技术遗产开放出来,背后的战略意图相当耐人寻味。 要理解这个决定的分量,我们不妨先看看Model S和Model X到底意味着什么

    ThinkPHP中Model的appendRelation_追加关联模型数据【技巧】
    ThinkPHP中Model的appendRelation_追加关联模型数据【技巧】

    appendRelationAttr可将一对一关联模型字段扁平化到主模型数据同级,不修改数据库,需配合with预加载,适用于API输出格式优化,支持运行时单次操作,不与$append获取器冲突,处理数据集需遍历模型实例。

    ThinkPHP中Model的saveAll_批量更新与事务一致性保障【技巧】
    ThinkPHP中Model的saveAll_批量更新与事务一致性保障【技巧】

    ThinkPHP的saveAll方法对主键识别敏感,主键缺失或无效会退化为全表更新或静默新增。该方法不保证事务原子性,需显式包裹事务并拆分批处理以防内存溢出。大批量更新需确保索引并拆分批次,避免间隙锁或表锁,字段名必须与模型主键一致。

    ThinkPHP中Model的isUpdate方法_强制控制新增或更新行为【技巧】
    ThinkPHP中Model的isUpdate方法_强制控制新增或更新行为【技巧】

    ThinkPHP中Model的isUpdate方法并非强制开关,而是手动干预模型新增或更新状态。save()依据模型内部状态判断,isUpdate(true)在已查询对象上可能不生效,isUpdate(false)可强制新增但需注意主键冲突。特定场景需手动干预,与静态update方法有本质区别,后者绕过模型事件直接操作查询构造器。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。