Eloquent模型正确转数组需用toArray()而非json_encode(),它遵守$hidden/$visible、处理关联/访问器/$casts,但关联须预加载,日期格式可全局或局部调整,敏感字段用$hidden过滤。

直接用 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)拦截。漏掉任意一环,输出就不可控。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











