Co je Query Builder a jak se vztahuje k Eloquentu?

Question

Accepted Answer

**Query Builder** v Laravellu je fluent, řetězitelné rozhraní pro vytváření a spouštění databázových dotazů bez psaní raw SQL. **Eloquent je postaven na Query Builderu** — Eloquent modely jej používají v pozadí a Eloquent dotazy mohou používat všechny metody Query Builderu.

## Query Builder (úroveň databáze, přes 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 pracuje přímo s tabulkami (vrací objekty, ne Eloquent modely). Je řetězitelný a **automaticky používá parameter binding** — což brání SQL injection útokům.

## Eloquent používá stejné fluent metody

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

Když řetězíte metody na Eloquent modelu, používáte pod kapotou Query Builder — ale dostanete zpět **modely** (se vztahy, accessory a metodami) místo jednoduchých objektů.

## Pokročilé dotazy (oba je podporují)

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

Oba podporují joins, agregace, subqueries a složité podmínky.

## Kdy použít co

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

## Proč je to důležité

Porozumění Query Builderu a jeho vztahu k Eloquentu je důležité pro efektivní práci s databázemi v Laravellu a pro volbu správného nástroje pro každou situaci.

Klíčová insight je, že **Eloquent je postaven na Query Builderu** — fluent, řetězitelné metody, které používáte na Eloquent modelech (`where`, `orderBy`, `join`, atd.), jsou metodami Query Builderu, což znamená, že naučením se jednoho se naučíte oběma.

Query Builder poskytuje čistý, SQL-injection-bezpečný (pomocí automatického parameter bindingu) způsob, jak vytvářet dotazy bez psaní raw SQL, a Eloquent na to vrství funkcionalitu modelu (vztahy, accessory, metody).

Znalost **kdy použít co** je praktická dovednost: **Eloquent** pro většinu aplikační logiky (dostanete bohaté objekty modelů se vztahy a chováním) a **Query Builder přímo** (`DB::table`) pro lehké dotazy bez overhead modelů, komplexní reporting/agregace nebo když nepotřebujete plné modely — což může být efektivnější v určitých případech.

Oba bezpečně zvládají složité dotazy (joins, agregace, subqueries) se stejným fluent API.

Porozumění Query Builderu, tomu, jak na něm Eloquent staví, sdíleným bezpečným parameter bindingům (brání SQL injection), a volbě mezi nimi, je důležitá znalost pro psaní efektivního a bezpečného kódu pro databáze v Laravellu, protože přístup k databázím je centrální pro většinu aplikací a volba správné úrovně (model-bohatý Eloquent vs lehký Query Builder) ovlivňuje jak přehlednost, tak výkon.