Laravel 8如何在Eloquent查询结果上直接调用自定义Trait方法

你要实现MyModel::get()->myFunction()的链式调用效果，不需要额外实例化模型，核心是为模型绑定自定义Eloquent集合，将处理方法定义在集合层，具体实现如下：

1. 调整Trait适配集合上下文 #

修改原有Trait，移除方法的Collection传参——因为方法定义在集合类中时，可以直接通过$this访问当前查询返回的全部结果集：

<?php

namespace App\Traits;

trait MyCollectionTrait
{
    public function myFunction(): array
    {
        // 业务逻辑直接通过$this操作集合数据
        // 例：遍历集合 foreach ($this as $item) { ... }
        return [];
    }
}

2. 创建自定义集合类 #

新建继承自框架原生Eloquent集合的自定义类，引入上述Trait：

<?php

namespace App\Collections;

use Illuminate\Database\Eloquent\Collection;
use App\Traits\MyCollectionTrait;

class MyModelCollection extends Collection
{
    use MyCollectionTrait;
}

3. 模型绑定自定义集合 #

在对应模型中重写newCollection方法，让模型查询结果返回你自定义的集合实例：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Collections\MyModelCollection;

class MyModel extends Model
{
    // 模型其他配置（表名、填充字段等）

    public function newCollection(array $models = [])
    {
        return new MyModelCollection($models);
    }
}

最终调用方式 #

配置完成后即可直接按你预期的方式调用，不需要手动传参、不需要额外实例化模型：

public function index()
{
    $data = MyModel::get(['id', 'value'])->myFunction();
    return response()->json($data, 200);
}

可选全局实现方案 #

如果你的方法是通用逻辑，需要在所有模型的查询集合上调用，可以直接在AppServiceProvider的boot方法中注册集合宏，不需要单独创建自定义集合类：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Database\Eloquent\Collection;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Collection::macro('myFunction', function () {
            // $this 指向当前调用的集合实例
            return [];
        });
    }
}

注意：宏注册的方法会挂载到所有Eloquent集合实例上，适合通用工具方法，如果是单模型专属逻辑优先使用自定义集合的方案，避免全局污染。

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