Query Builder 是什么？它与 Eloquent 有什么关系？

Question

Accepted Answer

Laravel 的 **Query Builder** 是一个流畅的、可链式调用的接口，用于构建和执行数据库查询，而无需编写原始 SQL。**Eloquent 是建立在 Query Builder 之上的** — Eloquent 模型在幕后使用它，Eloquent 查询可以使用所有 Query Builder 方法。

## Query Builder（数据库级别，通过 DB facade）

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

Query Builder 直接与表交互（返回普通对象，而非 Eloquent 模型）。它是可链式的，**自动使用参数绑定** — 防止 SQL 注入。

## Eloquent 使用相同的流畅方法

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

当你在 Eloquent 模型上链式调用方法时，你在幕后使用的是 Query Builder — 但你获得的是 **模型**（带有关系、访问器和方法），而不是普通对象。

## 高级查询（两者都支持）

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

两者都支持 join、聚合、子查询和复杂条件。

## 何时使用哪个

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## 为什么这很重要

理解 Query Builder 及其与 Eloquent 的关系对于在 Laravel 中有效地使用数据库，以及为每种情况选择正确的工具都很重要。

关键的洞察是 **Eloquent 是建立在 Query Builder 之上的** — 所以你在 Eloquent 模型上使用的流畅、可链式调用的方法（`where`、`orderBy`、`join` 等）都是 Query Builder 的方法，这意味着学习一个就能教会你两个。

Query Builder 提供了一种干净、防止 SQL 注入的方式（通过自动参数绑定）来构建查询，无需编写原始 SQL，而 Eloquent 在其之上分层了模型功能（关系、访问器、方法）。

**知道何时使用哪个** 是实际技能：**Eloquent** 用于大多数应用逻辑（你获得具有关系和行为的丰富模型对象），**直接 Query Builder**（`DB::table`）用于没有模型开销的轻量级查询、复杂的报告/聚合，或当你不需要完整模型时 — 这在某些情况下可能更高效。

两者都安全地处理复杂查询（join、聚合、子查询），使用相同的流畅 API。

理解 Query Builder、Eloquent 如何在其基础上构建、共享的安全参数绑定（防止 SQL 注入）以及在两者之间的选择，是在 Laravel 中编写高效、安全数据库代码的重要知识，因为数据库访问是大多数应用的核心，选择适当的层级（模型丰富的 Eloquent 与轻量级 Query Builder）会影响清晰度和性能。

Query Builder（数据库级别，通过 DB facade）

Eloquent 使用相同的流畅方法

高级查询（两者都支持）

何时使用哪个

为什么这很重要

question.related