Eloquent模型转数组或JSON的实用方法

Eloquent模型转数组或JSON看似简单，实则暗藏多重控制逻辑：必须使用`toArray()`或`toJson()`而非`json_encode()`，才能正确遵循`$hidden`/`$visible`、处理关联关系（需预加载）、触发访问器和类型转换（`$casts`），同时避免敏感字段泄露、日期格式错乱、关联数据缺失等高频问题；真正关键的不是语法调用，而是理清序列化过程中模型自身配置、关联加载状态、访问器执行时机及中间层（如API Resource）的协同机制——掌控这些，才能让输出稳定、安全、符合业务预期。

直接用 toArray() 或 toJson() 就能转，但实际项目里常遇到字段丢失、关系没展开、日期格式错乱、敏感字段泄露等问题——根本原因不是不会调用方法，而是没理解序列化时的控制权在哪儿。

怎么让 Eloquent 模型正确转成数组？

别直接 json_encode($model)，它会暴露所有属性（包括私有、未填充的），还可能触发无限递归。必须走 Eloquent 提供的序列化通道。

• toArray() 是入口，它会递归处理模型、关联、访问器（getXXXAttribute）和 $casts
• 若模型有 $hidden 或 $visible，toArray() 会严格遵守；但关联模型默认不自动展开，得手动加载
• 未 load() 的关联在 toArray() 中为空数组（不是 null），容易误判为“没数据”
• 示例：

  $user = User::with('posts')->find(1);
  var_dump($user->toArray()); // posts 关系内容存在

为什么 toJson() 输出的日期是 ISO 格式，但前端要时间戳？

因为 Eloquent 默认用 Carbon::toIso8601String() 序列化日期，不是 bug，是设计。要改就得动序列化行为本身。

• 全局改：在 AppServiceProvider::boot() 里重写 Carbon::serializeUsing()，但会影响所有 Carbon 实例，风险大
• 局部改：在模型里加访问器，比如 getCreatedAtTimestampAttribute()，然后把 $appends 加上 'created_at_timestamp'
• 更稳妥的做法：转 JSON 前先 toArray()，再用 PHP 数组函数批量处理日期字段，避免污染模型逻辑

关联模型不显示，或者只显示 ID？

这是最常踩的坑：Eloquent 不会在序列化时“自动 eager load”，toJson() 只序列化当前已加载的数据。

• 检查是否用了 with() / load() —— 没加载，toArray() 里对应键就是空数组
• 如果用了 belongsTo 关系（如 Post->user()），默认只存 user_id，toArray() 不会自动查出关联模型，除非你显式 ->load('user')
• 避免 N+1：别在循环里对每个模型单独 load()，统一用 with() 预加载
• 注意：setRelation() 手动绑定的关系，toArray() 会识别并序列化，但不会走访问器逻辑

如何安全过滤敏感字段（比如 password_hash）？

靠 $hidden 最直接，但要注意它对所有序列化路径（toArray()、toJson()、API Resource）都生效，且不可逆。

• 在模型里声明：protected $hidden = ['password_hash', 'remember_token'];
• 若需动态控制（比如管理员能看到，普通用户不能），不要依赖 $hidden，改用 API Resource 或手动 only()/except()
• toArray() 后还能链式调用：$user->toArray()['name']，但别对敏感字段做这种假设性取值
• 特别注意：$casts 对 $hidden 字段无效，所以即使字段被隐藏，cast 还是会尝试执行（可能报错）

真正难的从来不是调哪个方法，而是搞清「谁在什么时候决定哪些字段该出现」——模型自身的 $hidden/$casts、关联是否已加载、访问器是否被触发、序列化前有没有被其他中间层（比如 Resource）拦截。漏掉任意一环，输出就不可控。

到这里，我们也就讲完了《Eloquent模型转数组或JSON的实用方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！