Laravel Eloquent与Query Builder区分及模型方法调用问题

问题1：以下代码使用的是Eloquent还是Query Builder？ #

$q = Topic::from('topic')
    ->join( 'subject', 'subject.id', '=', 'topic.subject_id')
    ->select( 'topic.*',
        'subject.name as subject_name',
        )
    ->get();

答案：Eloquent
这段代码通过Topic模型（继承自Laravel的Model类）发起查询，属于Eloquent查询。Eloquent底层基于Query Builder实现，但入口是模型类，最终返回的是Topic模型实例集合，而非普通对象/数组。

问题2：若问题1的答案是Eloquent，那么以下是否为正确的Query Builder写法？ #

$q = DB::table('topic')
    ->join( 'subject', 'subject.id', '=', 'topic.subject_id')
    ->select( 'topic.*',
        'subject.name as subject_name',
        )
    ->get();

答案：正确
Query Builder的核心入口是DB::table()，直接指定数据表名进行查询操作。这段代码的逻辑和问题1的Eloquent查询完全一致，只是入口换成了Query Builder的标准写法，返回的是包含普通stdClass对象的集合。

问题3：我的Topic模型中有一个获取图片路径的image()方法，如何通过问题2中的Query Builder调用该方法？是否有更优的图片访问方式？ #

class Topic extends Model
{
    public function image()
    {
        //example
        return $pathImage;
    }
}

调用模型方法的方案 #

Query Builder返回的是普通对象/数组，并非Topic模型实例，因此无法直接调用模型内的image()方法。可以通过以下方式转换后调用：

// 将Query Builder结果转换为Topic模型实例
$q = DB::table('topic')
    ->join('subject', 'subject.id', '=', 'topic.subject_id')
    ->select('topic.*', 'subject.name as subject_name')
    ->get()
    ->map(fn($item) => new Topic((array)$item));

// 现在可以调用image()方法
foreach ($q as $topic) {
    echo $topic->image();
}

注意：需要确保Topic模型的$fillable属性包含所有需要填充的字段，避免批量赋值异常。

更优的图片访问方式 #

推荐使用Eloquent关联+模型方法的组合，更符合Laravel的ORM设计理念：

1. 先在Topic模型中定义与Subject的关联关系：

class Topic extends Model
{
    protected $fillable = ['subject_id', ...]; // 根据实际字段调整

    // 定义与Subject的关联
    public function subject()
    {
        return $this->belongsTo(Subject::class);
    }

    public function image()
    {
        return $pathImage;
    }
}

2. 使用Eloquent查询并预加载关联：

// 预加载subject关联，避免N+1查询
$q = Topic::with('subject')->get();

// 直接调用模型方法和关联属性
foreach ($q as $topic) {
    echo $topic->image(); // 调用图片路径方法
    echo $topic->subject->name; // 获取关联的学科名称
}

这种方式代码更简洁、可读性更强，同时能利用Eloquent的ORM特性（如关联预加载、模型事件等），维护成本更低。

Eloquent与Query Builder核心区别 #

• Eloquent：属于ORM（对象关系映射），通过模型类操作数据库，返回模型实例。支持关联关系、访问器/修改器、模型事件等特性，代码更面向对象，适合复杂业务场景，可读性和维护性更高。
• Query Builder：基于数据库连接的查询构造器，通过DB::table()直接操作数据表，返回普通对象/数组。语法更贴近原生SQL，灵活性更高，适合简单查询或需要精细控制SQL的场景，性能与Eloquent几乎无差异（合理使用预加载的情况下）。

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