X'inhu l-query builder u kif hu relatat ma' Eloquent?

Question

Accepted Answer

Laravel's **Query Builder** huwa interfaccia fluent u chainable għall-bini u tħaddim ta' queries għad-database mingħajr ma tikteb raw SQL. **Eloquent huwa mibni fuq il-Query Builder** — il-mudelli ta' Eloquent jużawhom taħt il-kopertura, u l-queries ta' Eloquent jistgħu jużaw il-metodi kollha tal-Query Builder.

## Il-Query Builder (livell database, permezz tal-facade DB)

```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']);
```

Il-Query Builder jaħdem direttament mat-tabelli (jirritorna oġġetti tal-plain, mhux mudelli ta' Eloquent). Huwa chainable u **awtomatikament juża parameter binding** — jipprevjeni SQL injection.

## Eloquent juża l-istess metodi fluent

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

Malajr tikkatenah metodi fuq mudell ta' Eloquent, int tuża l-Query Builder taħt il-kopertura — imma tikseb **mudelli** (b'relazzjonijiet, accessors, u metodi) minflok oġġetti plain.

## Queries avvanzati (it-tnejn jissuportaw dawn)

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

It-tnejn jissuportaw joins, aggregates, subqueries, u kundizzjonijiet kumplessi.

## Meta tuża liema

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

## Għaliex dan hu importanti

L-għarfien tal-Query Builder u l-relazzjoni tiegħu ma' Eloquent hu importanti biex taħdem b'mod effettiv mad-databases f'Laravel u biex tagħżel l-aħjar għodda għal kull sitwazzjoni.

L-insight ewlieni hu li **Eloquent huwa mibni fuq il-Query Builder** — allura l-metodi fluent u chainable li tuża fuq mudelli ta' Eloquent (`where`, `orderBy`, `join`, eċċ.) huma ta' l-Query Builder, li jfisser li t-tagħlim ta' wieħed jgħallmek it-tnejn.

Il-Query Builder jipprovdi mod clean, safe minn SQL-injection (permezz ta' automatic parameter binding) biex tibni queries mingħajr ma tikteb raw SQL, u Eloquent iddaħħal funzjonalità tal-mudell (relazzjonijiet, accessors, metodi) fuq quddiem.
"}}