Çfarë është query builder-i dhe si lidhet me Eloquent-in?

Question

Accepted Answer

Laravel's **Query Builder** është një fluent, chainable interfacë për ndërtimin dhe ekzekutimin e pyetjeve të bazës së të dhënave pa shkruar SQL të pastër. **Eloquent është ndërtuar mbi Query Builder** — modelet Eloquent e përdorin atë nën kapak, dhe pyetjet Eloquent mund të përdorin të gjitha metodat e Query Builder.

## Query Builder (në nivelin e bazës së të dhënave, përmes 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 punon drejtpërdrejt me tabela (kthyhet objekte të zakonshme, jo modele Eloquent). Është chainable dhe **automatikisht përdor parameter binding** — parandalimi i SQL injection.

## Eloquent përdor të njëjtat metoda 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.)
```

Kur zinxhiruani metoda në një model Eloquent, jeni duke përdorur Query Builder nën kapak — por merrni **modele** (me relacione, accessor-ë, dhe metoda) në vend të objekteve të zakonshme.

## Pyetje të avancuara (të dy mbështesin këto)

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

Të dy mbështesin joins, agreguat, subqueries, dhe kushte komplekse.

## Kur të përdorni cilën

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

## Pse ka rëndësi

Përfaqésimi i Query Builder dhe marrëdhënies së tij me Eloquent-in është i rëndësishëm për të punuar në mënyrë efektive me bazat e të dhënave në Laravel dhe për të zgjedhur mjetin e duhur për çdo situatë.

Ndësimi kryesor është që **Eloquent është ndërtuar mbi Query Builder** — kështu që metodat fluent, chainable që përdorni në modelet Eloquent (`where`, `orderBy`, `join`, etj.) janë të Query Builder, që do të thotë se mësimi i njërit ju mëson të dy.

Query Builder jep një mënyrë të pastër, të sigurt nga SQL-injection (përmes parameter binding automatik) për ndërtimin e pyetjeve pa shkruar SQL të pastër, dhe Eloquent shton funksionalitetin e modelit (relacionet, accessor-ët, metodat) në krye.

Dijenia **se kur të përdorin cilën** është aftësia praktike: **Eloquent** për shumicën e logjikës së aplikacionit (merrni objekte modeli të pasura me relacione dhe sjellje), dhe **Query Builder drejtpërdrejt** (`DB::table`) për pyetje të lehta pa harapën e modelit, raportim/agregat kompleks, ose kur nuk keni nevojë për modele të plotë — e cila mund të jetë më efikase për raste të caktuara.

Të dy kanë në mënyrë të sigurt pyetje komplekse (joins, agreguat, subqueries) me të njëjtën API fluent.

Përfaqësimi i Query Builder, se si Eloquent ndërtohet mbi të, parameter binding-u i sigurt i përbashkët (parandalimi i SQL injection), dhe zgjedhja mes tyre është njohuri e rëndësishme për shkrimin e kodit efikas dhe të sigurt të bazës së të dhënave në Laravel, pasi qasja në bazën e të dhënave është qendrore për shumicën e aplikacioneve dhe zgjedhja e nivelit të duhur (model-i i pasur Eloquent përkundër Query Builder i lehtë) ndikon në qartësinë dhe performancën.