Laravel 9中如何更优雅地转换集合内模型的键名？

日常开发中，我们常需要将集合内Eloquent模型的键名做映射转换，比如原本会这么写：

return $objects->map(function($item){
    return [
        'id' => $item->id,
        'label' => $item->name,
        'image' => $item->thumbnail,
    ];
});

想要实现类似keyChange这种更简洁的调用方式，Laravel 9里有几种更优的方案：

1. 利用原生mapWithKeys方法 #

Laravel集合自带的mapWithKeys方法可以直接完成键值映射，写法比普通map更贴合键名转换的场景：

return $objects->mapWithKeys(function ($item) {
    return [
        'id' => $item->id,
        'label' => $item->name,
        'image' => $item->thumbnail,
    ];
});

如果需要动态传入映射规则，可以基于这个方法封装自定义逻辑。

2. 自定义集合宏实现keyChange #

通过注册集合宏，可以实现你期望的keyChange调用方式，步骤如下：

在App\Providers\AppServiceProvider的boot方法中添加集合宏：

use Illuminate\Support\Collection;

public function boot()
{
    Collection::macro('keyChange', function (array $mapping, array $keepFields = ['id']) {
        return $this->map(function ($item) use ($mapping, $keepFields) {
            $result = [];
            
            // 保留指定的固定字段
            foreach ($keepFields as $field) {
                if (property_exists($item, $field)) {
                    $result[$field] = $item->$field;
                }
            }
            
            // 处理键名映射
            foreach ($mapping as $newKey => $oldKey) {
                if (property_exists($item, $oldKey)) {
                    $result[$newKey] = $item->$oldKey;
                }
            }
            
            return $result;
        });
    });
}

之后就可以像你想要的那样简洁调用：

return $objects->keyChange(['label' => 'name', 'image' => 'thumbnail']);

如果不需要默认保留id，可以传入空数组覆盖$keepFields参数。

3. 用API Resource处理模型转换（适合API场景） #

如果是面向API的开发，Laravel的API Resource是更优雅的解决方案，复用性更强：

创建一个资源类（比如App\Http\Resources\ItemResource）：

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class ItemResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'label' => $this->name,
            'image' => $this->thumbnail,
        ];
    }
}

调用时直接用集合资源输出：

return ItemResource::collection($objects);

这种方式还能根据请求参数动态调整返回字段，扩展性更好。

内容的提问来源于stack exchange，提问作者karatecode