在 laravel 中，可通过 `append()` 方法在运行时动态添加访问器属性到查询结果中，避免全局 `$appends` 导致的冗余数据传输，提升 api 响应效率。
当你在模型中定义了访问器（如 getPermissionsAttribute）并希望按需将其包含在 JSON 序列化结果中（而非始终通过 $appends 全局追加），Laravel 提供了优雅的运行时控制机制：append() 方法。
该方法适用于 Eloquent 集合（Collection）或单个模型实例，允许你仅在特定查询场景下注入访问器值，从而精准控制前端接收的数据结构，显著减少不必要的字段传输和序列化开销。
✅ 正确用法示例：
HISUI 前端框架开发指南（IRIS版）
下载
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
// 查询模型，并仅在需要时动态追加 'permissions' 访问器
return Model::where('set_id', $request->set)
->without('set')
->with('user:id,first_name,last_name,profile_photo')
->get()
->append('permissions'); // ← 运行时追加单个访问器支持批量追加多个访问器：
->get() ->append(['permissions', 'full_name', 'profile_photo_thumb']);
⚠️ 重要注意事项：
- append() 必须作用于 Eloquent Collection 实例（即调用 get() 之后），不可用于查询构造器（Builder）阶段（如 where(...)->append(...)->get() ❌ 会报错）。
- 访问器名称需与 get{Foo}Attribute 中的 {Foo} 严格匹配（首字母大写、驼峰式），例如 getPermissionsAttribute → 使用 'permissions'（小写蛇形，Laravel 自动转换）。
- 若需在 API 资源（Resource）中精细控制，推荐结合 JsonResource 的 toArray() 方法按需添加，比 append() 更具可维护性与类型安全。
? 进阶建议：
对于复杂权限逻辑（如你示例中的 json_encode($new)），建议将访问器返回原生数组（return $new;），再由资源层统一处理 JSON 序列化，既利于测试，也避免重复编码/解码。若必须返回 JSON 字符串，请确保前端明确预期格式。
总之，append() 是替代全局 $appends 的轻量级、按需方案，让数据输出真正“所见即所需”。
