Query builder คืออะไร และเกี่ยวข้องกับ Eloquent อย่างไร?

Question

Accepted Answer

**Query Builder** ของ Laravel คือ interface ที่ลื่นไหลและเชื่อมต่อกันได้สำหรับการสร้างและรัน query ฐานข้อมูลโดยไม่ต้องเขียน SQL แบบดิบ **Eloquent ถูกสร้างขึ้นบน Query Builder** กล่าวคือ Eloquent model ใช้มันอยู่เบื้องหลัง และ Eloquent query สามารถใช้ method ทั้งหมดของ Query Builder ได้

## Query Builder (ระดับ database ผ่าน 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 ทำงานกับตารางโดยตรง (return object ธรรมดา ไม่ใช่ Eloquent model) มันเชื่อมต่อกันได้และ **ใช้ parameter binding โดยอัตโนมัติ** ซึ่งป้องกัน SQL injection

## Eloquent ใช้ method ที่ลื่นไหลแบบเดียวกัน

```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.)
```

เมื่อคุณเชื่อมต่อ method บน Eloquent model คุณกำลังใช้ Query Builder อยู่เบื้องหลัง แต่คุณจะได้ **model** กลับมา (พร้อม relationship, accessor และ method) แทนที่จะเป็น object ธรรมดา

## Query ขั้นสูง (ทั้งสองรองรับ)

```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, aggregate, subquery และเงื่อนไขที่ซับซ้อน

## เมื่อใดควรใช้แบบใด

```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** ดังนั้น method ที่ลื่นไหลและเชื่อมต่อกันได้ที่คุณใช้บน Eloquent model (`where`, `orderBy`, `join` ฯลฯ) จึงเป็นของ Query Builder หมายความว่าการเรียนรู้สิ่งหนึ่งจะสอนคุณทั้งสองอย่าง

Query Builder มอบวิธีที่สะอาดและปลอดภัยจาก SQL injection (ผ่าน parameter binding อัตโนมัติ) ในการสร้าง query โดยไม่ต้องเขียน SQL แบบดิบ และ Eloquent เพิ่มฟังก์ชันของ model (relationship, accessor, method) ไว้ด้านบน

การรู้ว่า **เมื่อใดควรใช้แบบใด** เป็นทักษะเชิงปฏิบัติ: **Eloquent** สำหรับตรรกะแอปพลิเคชันส่วนใหญ่ (คุณจะได้ model object ที่อุดมสมบูรณ์พร้อม relationship และพฤติกรรม) และ **Query Builder โดยตรง** (`DB::table`) สำหรับ query แบบเบาที่ไม่มี overhead ของ model, การรายงาน/aggregate ที่ซับซ้อน หรือเมื่อคุณไม่ต้องการ model เต็มรูปแบบ ซึ่งอาจมีประสิทธิภาพมากกว่าในบางกรณี

ทั้งสองจัดการ query ที่ซับซ้อน (join, aggregate, subquery) ได้อย่างปลอดภัยด้วย fluent API แบบเดียวกัน

การเข้าใจ Query Builder วิธีที่ Eloquent สร้างบนมัน parameter binding ที่ปลอดภัยที่ใช้ร่วมกัน (ป้องกัน SQL injection) และการเลือกระหว่างทั้งสอง เป็นความรู้ที่สำคัญสำหรับการเขียนโค้ดฐานข้อมูลที่มีประสิทธิภาพและปลอดภัยใน Laravel เนื่องจากการเข้าถึงฐานข้อมูลเป็นหัวใจของแอปพลิเคชันส่วนใหญ่ และการเลือกระดับที่เหมาะสม (Eloquent ที่อุดมด้วย model เทียบกับ Query Builder ที่เบา) ส่งผลต่อทั้งความชัดเจนและประสิทธิภาพ