Cad is an Query Builder ann agus conas a bhaineann sé do Eloquent?

Question

Accepted Answer

**Query Builder** Laravel ina dhéanann sé fhéagsán intuigthe, dhomhanda do dhréachtú agus rith fhiafraí bhunachair gan SQL amh a scríobh. **Tá Eloquent bunaithe ar bharr an Query Builder** — úsáideann múnlaí Eloquent é faoin bhonnet, agus is féidir le fiafraí Eloquent gach modh Query Builder a úsáid.

## An Query Builder (leibhéal an bhunairc, trí façade 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']);
```

Oibríonn an Query Builder go díreach le táblaí (ag fíltéartha rudaí simplí, ní múnlaí Eloquent). Tá sé domhanda agus **úsáideann sé ceangal pharaiméadair go huathoibríoch** — ag cosc SQL injection.

## Úsáideann Eloquent na modhanna fluent céanna

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

Nuair a chaingeann tú modhanna ar mhúnla Eloquent, úsáideann tú an Query Builder thíos — ach faigheann tú **múnlaí** ar ais (le caidreamh, inrochtana, agus modhanna) seachas rudaí simplí.

## Fiafraí fhorgafa (tacaíonn an dá thóir dóibh seo)

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

Tacaíonn an dá thóir le joins, aggregates, subqueries, agus coinníollacha casta.

## Cathain a úsáid dá bharr

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

## Cad chuige a bhraithimid air

Tá sé tábhachtach tuiscint a bheith agat ar an Query Builder agus ar a chaidreamh do Eloquent chun oibriú go héifeachtach le bunaichí sonraí i Laravel agus an uirlis cheart a roghnú do gach cás.

Is é an príomh-léargas ná gur **tá Eloquent bunaithe ar an Query Builder** — mar sin tá na modhanna fluent, dhomhanda a úsáideann tú ar mhúnlaí Eloquent (`where`, `orderBy`, `join`, srl.) ó chuid an Query Builder, rud a chiallaíonn go bhfoghlaimeoidh an ceann amháin an dá théarma.

Soláthraíonn an Query Builder bealach geal, slán ó SQL-injection (trí cheangal pharaiméadair uathoibríocha) chun fiafraí a dhréachtú gan SQL amh a scríobh, agus cuireann Eloquent feidhmiúlacht múnla (caidreamh, inrochtana, modhanna) air bharr.

Tá sé tábhachtach a bheith a fhios agat **cathain a úsáid dá bharr**: **Eloquent** do bhformhór na loighic fheidhmchláir (gheobhaidh tú rudaí saibhre múnla le caidreamh agus iompar), agus an **Query Builder go díreach** (`DB::table`) do thúr fhéalaithe gan mbarúil mhúnla, fiafraí casta tuairisceáin/aggregations, nó nuair nach bhfuil gá agat do bhúnmhúnlaí iomlána — is féidir go bhfuil sé níos éifeachtaí i gcásanna áirithe.

Labhraíonn an dá thóir go sábháilte le fiafraí casta (joins, aggregates, subqueries) leis an API fluent céanna.

Tá sé tábhachtach a thuiscint don Query Builder, conas a thógann Eloquent air, an ceangal slán pharaiméadair a roinnt (ag cosc SQL injection), agus an rogha eatarthu — toisc go bhfuil faisnéis bhunúsach slánaitheoracha lárnach don chuid is mó d'fheidhmchláir agus go dtéann an leibhéal oiriúnach (múnla-shaibhir Eloquent vs Query Builder éadrom) i bhfeidhm ar an soiléireacht agus ar dhul chun cinn araon.