LaravelEloquenttoArray使用全解析

你在学习文章相关的知识吗？本文《Laravel Eloquent toArray 方法使用详解》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

在 Laravel 中，`toArray()` 是 Collection 或 Eloquent 模型实例的方法，不能直接在查询构造器（Builder）上调用；需先执行 `get()` 获取 Collection，再链式调用 `toArray()` 将结果转为纯 PHP 数组。

当你使用 Eloquent 查询构建器（如 HrHorizontalPreviredCalculation::from(...)）时，整个链式调用返回的是 Illuminate\Database\Eloquent\Builder 实例，而该类不提供 toArray() 方法——这就是你遇到 Call to undefined method ... Builder::toArray() 错误的根本原因。

✅ 正确做法是：先调用 get() 执行查询并返回 Illuminate\Database\Eloquent\Collection，再在其上调用 toArray()。Collection::toArray() 会递归将集合内所有模型（及关联关系，如已加载）转换为数组。

以下是修正后的完整示例：

$data = HrHorizontalPreviredCalculation::from('hr_horizontal_previred_calculations')
    ->selectRaw('`Rut`,`DV`,`Apellido Paterno`,`Apellido Materno`,`Nombre`,`Sexo`,`Nacion`,`Tipo Pago`,`Periodo Desde`,`Periodo Hasta`,`Regimen`,`Tipo Trabajador`,`Dias Trabajados`,`Tipo Linea`,`Cod Movi`,`Fecha Desde`,`Fecha Hasta`,`Tramo Fam`,`Cargas Simples`,`Cargas Mat`,`Cargas Inv`,`Asig Familiar`,`Asig RetroAct`,`Reint Cargas`,`Sub Trab Jov`,`AFP`,`Impo Afp`,`Cot AFP`,`Aporte SIS`,`Ahorro AFP`,`Sust AFP`,`Tasa Pac AFP`,`Aporte idem`,`Num Per Sust`,`Per Desde Sust`,`Per Hasta Sust`,`Trab Pesado`,`% Trab Pesado`,`Cot Trab Pesado`,`Inst APVI`,`Num Contra APVI`,`Forma Pago APVI`,`Cotiza APVI`,`Cot Dep Conv`,`Inst APVC`,`Num Contra APVC`,`Forma Pago APVC`,`Cotiza APVC`,`Cot Emp APVC`,`Rut afi Volun`,`DV afi Volun`,`Ape Pat Volun`,`Ape Mat Volun`,`Nombre volun`,`Cod Mov Per`,`Fec Desde volun`,`Fec Hasta volun`,`Cod Afp volun`,`Monto Cap Volun`,`Monto aho Vol`,`Num Per Cotiza`,`Cod Ex caja`,`Tasa ex caja`,`Renta imp Fonasa`,`Cod INP`,`Renta desahu`,`Cod ex caja des`,`Tasa ex caja des`,`Cot Desahucio`,`Cotiza Fonasa`,`Cot Acc Trab INP`,`Boni Ley`,`Cargas fam INP`,`Bonos Gob`,`Cod Inst Salud`,`Num FUN`,`Impo Isapre`,`Moneda Plan`,`Cot Pactada`,`Cot Obli Isapre`,`Cot Ad Vol`,`Monto Ges`,`Cod CCAF`,`Impo CCAF`,`Cred Per CCAF`,`Desc Dental`,`Desc Leasing`,`Desc Seg Vida`,`Otros desc CCAF`,`Cot CCAF`,`Car Fam CCAF`,`Otros desc CCAF1`,`Otros desc CCAF2`,`Bono gob CCAF`,`Cod Sucur CCAF`,`Cod Mutual`,`Impo Mutual`,`Cotiza Mutual`,`Sucur Mutual`,`Renta Impo SC`,`Aporte Trab SC`,`Aporte empleador`,`Rut Pag Subs`,`DV Pag Subs`,`Centro costo`')
    ->where('period', $period)
    ->orderBy('employee_id', 'ASC')
    ->get() // ← 返回 Collection 实例
    ->toArray(); // ← ✅ 此时 toArray() 可安全调用

⚠️ 注意事项：

• 若只需单条记录，可用 first()->toArray()，但需确保结果非 null，建议加空值判断；
• toArray() 对 Collection 是深转换：每个模型及其已加载的关联（如 load('user')）也会转为数组；
• 如需更轻量、无模型开销的原始数组（跳过 Eloquent 模型层），可改用 Query Builder：DB::table('hr_horizontal_previred_calculations')->select(...)->where(...)->get()->toArray()；
• 避免在大型数据集上无节制使用 toArray()，因其会将全部结果加载到内存，必要时考虑分块处理（chunkById）或流式导出。

总结：牢记调用顺序 —— query()->get()->toArray()，而非 query()->toArray()。这是 Laravel Eloquent 使用中高频踩坑点之一，理解 Builder → Collection → Array 的数据流，能帮你快速定位并规避类似问题。

终于介绍完啦！小伙伴们，这篇关于《LaravelEloquenttoArray使用全解析》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！