应根据场景选择合适方法:一、pluck()+toarray()用于单字段高性能提取;二、get()->toarray()适合全字段结构化转换;三、map()->toarray()支持自定义字段映射;四、访问器实现业务语义透明转换;五、makevisible/makehidden动态控制字段可见性。

如果您在 Laravel 应用中需要对数据库查询结果进行结构化、可复用的转换处理,而非临时性拼接或手动遍历,则需避免直接操作原始 Collection 或数组。以下是实现查询结果动态转换的多种方法:
一、使用 pluck() + toArray() 提取单列并转为纯 PHP 数组
该方法适用于仅需某一字段全部值且后续需配合 in_array、array_search 等原生函数的场景,底层不实例化模型,性能开销最小。
1、调用 DB 查询构建器,指定表名与目标字段名。
2、链式调用 pluck('field_name') 获取该字段所有值,返回 Illuminate\Support\Collection 实例。
3、追加 toArray() 方法,将 Collection 转换为数字索引的纯 PHP 数组。
4、验证输出类型:使用 is_array($result) 与 !is_object($result) 确保结果为原生数组。
二、使用 get()->toArray() 批量获取全字段并转为多维数组
该方式适合需保留全部字段结构、且数据量可控(如后台配置表、字典表)的场景,会实例化完整模型或 StdClass 对象后再转数组。
1、调用 DB::table('table_name')->get() 获取结果集,返回 Illuminate\Support\Collection。
2、立即调用 toArray() 方法,将集合内每个对象逐个转为关联数组,形成二维 PHP 数组。
3、注意:若使用 Eloquent 模型调用 get(),则 toArray() 将受 $casts、$appends、$hidden 等模型属性影响。
4、关键提示:此方式会加载整行数据并构造对象,内存占用高于 pluck()。
三、使用 map()->toArray() 对查询结果做自定义字段映射
当需要在转换过程中重命名字段、合并值、格式化日期或添加计算字段时,map() 提供了灵活的闭包处理能力,且保持链式可读性。
1、先执行 DB::table('users')->get() 获取原始集合。
2、调用 map(fn($item) => [ 'uid' => $item->id, 'full_name' => trim("{$item->first_name} {$item->last_name}"), 'age_group' => $item->age >= 18 ? 'adult' : 'minor' ]) 进行字段重构。
3、最后调用 toArray() 输出标准化数组结构。
4、map() 中不可修改原始 $item 属性,仅能构造新数组;若需访问模型访问器逻辑,应改用 Eloquent 查询。
四、使用 Eloquent 访问器(Accessors)实现透明字段转换
当转换逻辑与业务语义强绑定(如价格单位换算、状态码转中文、时间格式标准化),且需在多处统一生效时,访问器是唯一能保证“读取即转换”的机制。
1、在对应模型类中定义 protected function getFieldNameAttribute($value) 方法,方法名遵循驼峰规则。
2、方法体内对 $value 执行转换,并 return 转换后结果,例如 return '¥' . number_format($value / 100, 2)。
3、确保该字段未被 $hidden 列表排除,且未被 $casts 强制覆盖原始类型。
4、调用 $model->field_name 即触发访问器,即使已调用 toArray() 或 toJson(),访问器返回值仍会被自动包含。
五、使用 toArray() 前动态控制可见字段
当需按请求上下文差异化输出字段(如 API 返回精简版、管理后台返回完整版),应在调用 toArray() 前通过模型实例方法干预字段可见性。
1、获取模型实例后,调用 $model->makeVisible(['id', 'name']) 显式暴露指定字段。
2、同步调用 $model->makeHidden(['password', 'api_token']) 隐藏敏感字段。
3、再执行 $model->toArray(),输出结果将严格限定于 makeVisible 指定字段,且排除 makeHidden 字段。
4、makeVisible/makeHidden 仅对当前模型实例生效,不影响其他实例或全局配置。











