Query builder क्या है और यह Eloquent से कैसे संबंधित है?

Question

Accepted Answer

Laravel का **Query Builder** raw SQL लिखे बिना database queries बनाने और चलाने के लिए एक fluent, chainable interface है। **Eloquent Query Builder के ऊपर बना है** — Eloquent models इसका उपयोग आंतरिक रूप से करते हैं, और Eloquent queries सभी Query Builder methods का उपयोग कर सकती हैं।

## Query Builder (database-level, 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 सीधे tables के साथ काम करता है (plain objects लौटाते हुए, Eloquent models नहीं)। यह chainable है और **स्वचालित रूप से parameter binding का उपयोग करता है** — SQL injection को रोकते हुए।

## Eloquent समान fluent methods का उपयोग करता है

```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 model पर methods chain करते हैं, तो आप नीचे Query Builder का उपयोग कर रहे हैं — लेकिन आपको plain objects के बजाय **models** वापस मिलते हैं (relationships, accessors, और methods के साथ)।

## Advanced queries (दोनों इनका समर्थन करते हैं)

```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();
```

दोनों joins, aggregates, subqueries, और जटिल conditions का समर्थन करते हैं।

## किसका उपयोग कब करें

```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 में databases के साथ प्रभावी ढंग से काम करने और प्रत्येक स्थिति के लिए सही tool चुनने के लिए महत्वपूर्ण है।

मुख्य अंतर्दृष्टि यह है कि **Eloquent Query Builder के ऊपर बना है** — इसलिए जो fluent, chainable methods आप Eloquent models पर उपयोग करते हैं (`where`, `orderBy`, `join`, आदि) वे Query Builder के हैं, जिसका अर्थ है एक सीखना आपको दोनों सिखाता है।

Query Builder raw SQL लिखे बिना queries बनाने का एक clean, SQL-injection-safe (स्वचालित parameter binding के माध्यम से) तरीका प्रदान करता है, और Eloquent इसके ऊपर model functionality (relationships, accessors, methods) की layer जोड़ता है।

**किसका उपयोग कब करना है** यह जानना व्यावहारिक कौशल है: अधिकांश application logic के लिए **Eloquent** (आपको relationships और behavior के साथ समृद्ध model objects मिलते हैं), और model overhead के बिना lightweight queries, जटिल reporting/aggregations, या जब आपको full models की आवश्यकता नहीं हो — के लिए सीधे **Query Builder** (`DB::table`), जो कुछ मामलों के लिए अधिक कुशल हो सकता है।

दोनों समान fluent API के साथ जटिल queries (joins, aggregates, subqueries) को सुरक्षित रूप से handle करते हैं।

Query Builder को समझना, Eloquent इस पर कैसे बनता है, साझा सुरक्षित parameter binding (SQL injection को रोकना), और उनके बीच चुनाव Laravel में कुशल, सुरक्षित database code लिखने के लिए महत्वपूर्ण ज्ञान है, क्योंकि database access अधिकांश applications के केंद्र में है और उपयुक्त स्तर (model-rich Eloquent बनाम lightweight Query Builder) चुनना clarity और performance दोनों को प्रभावित करता है।