Query builder là gì và nó liên hệ với Eloquent như thế nào?

Question

Accepted Answer

**Query Builder** của Laravel là một giao diện mạch lạc, có thể nối chuỗi để xây dựng và chạy các truy vấn database mà không cần viết SQL thô. **Eloquent được xây dựng trên Query Builder** — các model Eloquent dùng nó ở bên dưới, và các truy vấn Eloquent có thể dùng tất cả các method của Query Builder.

## Query Builder (cấp độ database, qua facade DB)

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

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // trả về các đối tượng chung (không phải model)

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

Query Builder làm việc trực tiếp với các bảng (trả về các đối tượng thuần, không phải model Eloquent). Nó có thể nối chuỗi và **tự động dùng parameter binding** — ngăn SQL injection.

## Eloquent dùng cùng các method mạch lạc

```php
// các truy vấn Eloquent hỗ trợ TẤT CẢ method của Query Builder (nó được xây dựng trên đó)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // trả về các MODEL User (với relationship, v.v.)
```

Khi bạn nối chuỗi các method trên một model Eloquent, bạn đang dùng Query Builder ở bên dưới — nhưng bạn nhận lại các **model** (với relationship, accessor, và method) thay vì các đối tượng thuần.

## Truy vấn nâng cao (cả hai đều hỗ trợ)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // join
    ->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();
```

Cả hai hỗ trợ join, aggregate, subquery, và các điều kiện phức tạp.

## Khi nào dùng cái nào

```text
Eloquent (Model::...) → mặc định — lấy model với relationship/accessor/method.
                        Tốt nhất cho hầu hết logic ứng dụng.
Query Builder (DB::table) → khi bạn muốn truy vấn nhẹ không có overhead của model,
                            báo cáo/aggregation phức tạp, hoặc tránh load model.
```

## Tại sao điều này quan trọng

Hiểu Query Builder và mối liên hệ của nó với Eloquent là quan trọng để làm việc hiệu quả với database trong Laravel và chọn công cụ phù hợp cho từng tình huống.

Insight then chốt là **Eloquent được xây dựng trên Query Builder** — nên các method mạch lạc, nối chuỗi mà bạn dùng trên model Eloquent (`where`, `orderBy`, `join`, v.v.) là của Query Builder, nghĩa là học một cái dạy bạn cả hai.

Query Builder cung cấp một cách sạch sẽ, an toàn trước SQL injection (qua parameter binding tự động) để xây dựng truy vấn mà không cần viết SQL thô, và Eloquent xếp chồng chức năng model (relationship, accessor, method) lên trên.

Biết **khi nào dùng cái nào** là kỹ năng thực tiễn: **Eloquent** cho hầu hết logic ứng dụng (bạn nhận được các đối tượng model phong phú với relationship và hành vi), và **Query Builder trực tiếp** (`DB::table`) cho truy vấn nhẹ không có overhead của model, báo cáo/aggregation phức tạp, hoặc khi bạn không cần model đầy đủ — điều có thể hiệu quả hơn cho một số trường hợp.

Cả hai xử lý an toàn các truy vấn phức tạp (join, aggregate, subquery) với cùng một API mạch lạc.

Hiểu Query Builder, cách Eloquent xây dựng trên nó, parameter binding an toàn chung (ngăn SQL injection), và lựa chọn giữa chúng là kiến thức quan trọng để viết code database hiệu quả, an toàn trong Laravel, vì truy cập database là trung tâm của hầu hết các ứng dụng và chọn cấp độ phù hợp (Eloquent giàu model vs Query Builder nhẹ) ảnh hưởng đến cả độ rõ ràng lẫn hiệu năng.