ਕਿਆ ਹੈ Query Builder ਅਤੇ ਇਹ Eloquent ਨਾਲ ਕਿਵੇਂ ਸੰਬੰਧਿਤ ਹੈ?

Question

Accepted Answer

Laravel ਦਾ **Query Builder** ਇੱਕ fluent, chainable interface ਹੈ ਜੋ ਕਿ database queries ਬਣਾਉਣ ਅਤੇ ਚਲਾਉਣ ਲਈ raw SQL ਲਿਖੇ ਬਿਨਾਂ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ। **Eloquent Query Builder ਦੇ ਉਪਰ ਬਣਿਆ ਹੋਇਆ ਹੈ** — Eloquent models ਇਸਨੂੰ underneath ਵਰਤਦੇ ਹਨ, ਅਤੇ 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 ਕਰਦੇ ਹੋ, ਤੁਸੀਂ underneath Query Builder ਵਰਤ ਰਹੇ ਹੋ — ਪਰ ਤੁਹਾਨੂੰ **models** ਵਾਪਸ ਮਿਲਦੇ ਹਨ (relationships, accessors, ਅਤੇ methods ਦੇ ਨਾਲ) plain 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, ਅਤੇ complex 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 ਦੇ ਨਾਲ ਪ্ਰਭਾਵਸ਼ਾਲੀ ਢੰਗ ਨਾਲ ਕਾਮ ਕਰਨ ਅਤੇ ਹਰ ਸਥਿਤੀ ਲਈ ਸਹੀ ਸਾਧਨ ਚੁਣਨ ਲਈ ਮਹੱਤਵਪੂਰਨ ਹੈ।

ਮੁੱਖ ਸਮਝ ਇਹ ਹੈ ਕਿ **Eloquent Query Builder ਦੇ ਉਪਰ ਬਣਿਆ ਹੋਇਆ ਹੈ** — ਇਸ ਲਈ fluent, chainable methods ਜੋ ਤੁਸੀਂ Eloquent models ਤੇ ਵਰਤਦੇ ਹੋ (`where`, `orderBy`, `join`, ਆਦਿ) Query Builder ਦੇ ਹਨ, ਮਤਲਬ ਕਿ ਇੱਕ ਸਿੱਖਣਾ ਤੁਹਾਨੂੰ ਦੋਵੇਂ ਸਿਖਾਉਂਦਾ ਹੈ।

Query Builder ਇੱਕ ਸਾਫ, SQL-injection-safe (automatic 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 ਤੋਂ ਬਿਨਾਂ, complex reporting/aggregations, ਜਾਂ ਜਦੋਂ ਤੁਹਾਨੂੰ full models ਦੀ ਲੋੜ ਨਹੀਂ — ਜੋ ਕਿ ਕੁਝ ਮਾਮਲਿਆਂ ਵਿੱਚ ਵਧੇਰੇ efficient ਹੋ ਸਕਦਾ ਹੈ।

ਦੋਵੇਂ ਸੁਰੱਖਿਤ ਢੰਗ ਨਾਲ complex queries (joins, aggregates, subqueries) ਨੂੰ ਸਮਾਨ fluent API ਨਾਲ ਸੰਭਾਲਦੇ ਹਨ।

Query Builder ਨੂੰ ਸਮਝਣਾ, ਕਿਵੇਂ Eloquent ਇਸ ਤੇ ਬਿੰਦੂ ਕਰਦਾ ਹੈ, ਸਾਂਝੀ safe parameter binding (SQL injection ਨੂੰ ਰੋਕਦਾ ਹੈ), ਅਤੇ ਉਨ੍ਹਾਂ ਵਿਚਕਾਰ ਚੋਣ Laravel ਵਿੱਚ efficient, secure database code ਲਿਖਣ ਲਈ ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਹੈ, ਕਿਉਂਕਿ database access ਜ਼ਿਆਦਾਤਰ applications ਲਈ ਕੇਂਦਰੀ ਹੈ ਅਤੇ ਢੁਕਵੇਂ ਪੱਧਰ (model-rich Eloquent vs lightweight Query Builder) ਦੀ ਚੋਣ clarity ਅਤੇ performance ਦੋਵਾਂ ਨੂੰ ਪ੍ਰਭਾਵਿਤ ਕਰਦੀ ਹੈ।