PHP如何向包含对象的数组中添加新属性

API 探路者

2026-8-16

解决PHP中为Eloquent集合对象添加新属性的问题

问题分析

你当前代码存在两个核心问题：

DB::get()返回的是Eloquent集合对象，集合中的每个元素是stdClass或Eloquent模型实例，并非普通数组，因此不能用array_push操作对象。
$num = 1写在循环内部，每次迭代都会重置数值，导致所有对象的sucursal属性值都是SUCURSAL1。

正确实现方式

方式一：foreach循环直接赋值属性

将$num初始化在循环外，直接给对象添加属性：

$data = DB::table('guia_sucursal')
    ->join('colecciones','colecciones.id','=','guia_sucursal.coleccion_id')
    ->join('sucursales','colecciones.sucursal_destino_id','=','sucursales.id')
    ->select('colecciones.id as id','colecciones.titulo as titulo','colecciones.image as url','colecciones.codigo_barra as code_bar','sucursales.nombre as sucursal_destino')
    ->groupBy('guia_sucursal.coleccion_id')
    ->distinct('guia_sucursal.coleccion_id')
    ->get();

$num = 1; // 初始化在循环外
foreach ($data as $coleccion){
    // 直接给对象添加属性
    $coleccion->sucursal = "SUCURSAL".$num;
    $num++;
}

方式二：使用Collection的map方法（更优雅的集合操作）

利用Laravel集合的map方法，结合闭包实现属性添加，同时可以自动处理索引：

$data = DB::table('guia_sucursal')
    ->join('colecciones','colecciones.id','=','guia_sucursal.coleccion_id')
    ->join('sucursales','colecciones.sucursal_destino_id','=','sucursales.id')
    ->select('colecciones.id as id','colecciones.titulo as titulo','colecciones.image as url','colecciones.codigo_barra as code_bar','sucursales.nombre as sucursal_destino')
    ->groupBy('guia_sucursal.coleccion_id')
    ->distinct('guia_sucursal.coleccion_id')
    ->get()
    ->map(function($coleccion, $index) {
        // index从0开始，所以加1
        $coleccion->sucursal = "SUCURSAL".($index + 1);
        return $coleccion;
    });