Query Builder کیا ہے اور یہ Eloquent سے کیسے متعلق ہے؟

Question

Accepted Answer

Laravel کا **Query Builder** ایک fluent، chainable انٹرفیس ہے جو بغیر raw SQL لکھے ڈیٹا بیس کی queries بنانے اور چلانے کے لیے ہے۔ **Eloquent Query Builder کے اوپر بنایا گیا ہے** — Eloquent models اسے under the hood میں استعمال کرتے ہیں، اور Eloquent queries تمام Query Builder methods استعمال کر سکتی ہیں۔

## Query Builder (ڈیٹا بیس 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 کے ساتھ کام کرتا ہے (سادہ 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 کرتے ہیں، تو آپ underneath Query Builder استعمال کر رہے ہوتے ہیں — لیکن آپ کو **models** واپس ملتے ہیں (relationships، accessors، اور methods کے ساتھ) بجائے سادہ objects کے۔

## 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 میں ڈیٹا بیس کے ساتھ مؤثر طریقے سے کام کرنے اور ہر صورتحال کے لیے صحیح ٹول منتخب کرنے کے لیے اہم ہے۔

اہم نکتہ یہ ہے کہ **Eloquent Query Builder پر بنایا گیا ہے** — تو fluent، chainable methods جو آپ Eloquent models پر استعمال کرتے ہیں (`where`، `orderBy`، `join` وغیرہ) Query Builder کے ہیں، جس کا مطلب ہے کہ ایک سیکھنا دونوں سکھاتا ہے۔

Query Builder ایک صاف، SQL-injection سے محفوظ (خودکار parameter binding کے ذریعے) طریقہ فراہم کرتا ہے queries بنانے کے لیے بغیر raw SQL لکھے، اور Eloquent اس پر model functionality کو layer کرتا ہے (relationships، accessors، methods)۔

**کون سا استعمال کریں** یہ جاننا عملی مہارت ہے: **Eloquent** اکثر application logic کے لیے (آپ کو rich model objects ملتے ہیں relationships اور behavior کے ساتھ)، اور **Query Builder براہ راست** (`DB::table`) lightweight queries کے لیے بغیر model overhead کے، پیچیدہ reporting/aggregations کے، یا جب آپ کو مکمل models کی ضرورت نہیں — جو بعض صورتوں میں زیادہ موثر ہو سکتا ہے۔

دونوں محفوظ طریقے سے پیچیدہ queries کو سنبھالتے ہیں (joins، aggregates، subqueries) ایک جیسے fluent API کے ساتھ۔

Query Builder کو سمجھنا، کہ Eloquent اس پر کیسے بنتا ہے، مشترکہ محفوظ parameter binding (SQL injection سے روکتا ہے)، اور ان کے درمیان انتخار Laravel میں موثر، محفوظ ڈیٹا بیس کوڈ لکھنے کے لیے اہم علم ہے، کیونکہ ڈیٹا بیس تک رسائی زیادہ تر applications میں مرکزی ہے اور مناسب level (model سے مالا مال Eloquent بمقابلہ lightweight Query Builder) کا انتخاب وضاحت اور performance دونوں کو متاثر کرتا ہے۔