Query builder भनेको के हो र यो Eloquent संग कसरी सम्बन्धित छ?

Question

Accepted Answer

Laravel को **Query Builder** एक fluent, chainable interface हो जसले raw SQL लेख्न बिना डेटाबेस queries निर्माण र चलाउन सक्छ। **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 संग) फर्काउनुभएको हुनुहुन्छ।

## उन्नत 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 मा डेटाबेससंग प्रभावकारी ढङ्गले काम गर्न र प्रत्येक स्थितिको लागि सही उपकरण छनोट गर्न महत्त्वपूर्ण छ।

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

Query Builder एक स्वच्छ, SQL-injection-सुरक्षित (स्वचालित parameter binding को माध्यमबाट) तरिका प्रदान गर्छ raw SQL लेख्न बिना queries निर्माण गर्न, र Eloquent model functionality (relationships, accessors, methods) लाई माथिमा तहमा राख्छ।

**कुन प्रयोग गर्ने** भनेको व्यावहारिक कौशल हो: **Eloquent** अधिकांश application logic को लागि (तपाईले rich model objects relationships र behavior संग पाउनुहुन्छ), र **Query Builder सीधै** (`DB::table`) lightweight queries को लागि model overhead बिना, जटिल reporting/aggregations, वा जब तपाईलाई पूर्ण models चाहिदैन — जो निश्चित cases को लागि अधिक efficient हुन सक्छ।

दुवै सुरक्षित रूपमा जटिल queries (joins, aggregates, subqueries) एकै fluent API संग ह्यान्डल गर्छ।

Query Builder, Eloquent कसरी यो निर्माण गर्छ, साझेदारी सुरक्षित parameter binding (SQL injection रोक्षण), र तिनीहरूको बीचको छनोट बुझ्न Laravel मा कुशल, सुरक्षित डेटाबेस code लेख्न महत्त्वपूर्ण ज्ञान हो, किनकि डेटाबेस पहुँच अधिकांश applications को लागि केन्द्रीय छ र उपयुक्त level (model-rich Eloquent बनाम lightweight Query Builder) को छनोट दुवै स्पष्टता र कार्यक्षमता लाई असर गर्छ।