რა არის query builder და როგორ უკავშირდება იგი Eloquent-ს?

Question

Accepted Answer

Laravel-ის **Query Builder** არის fluent, chainable ინტერფეისი მონაცემთა ბაზის მოთხოვნების აგებისა და გაშვების জন্য ხელმისაწვდომი SQL-ის გარეშე. **Eloquent აგებულია Query Builder-ის ზეწოვებით** — Eloquent მოდელები იყენებენ მას შიგნით, და Eloquent მოთხოვნები შეიძლება გამოიყენონ ყველა Query Builder მეთოდი.

## Query Builder (მონაცემთა ბაზის დონე, 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 პირდაპირ მუშაობს ცხრილებთან (აბრუნებს ჩვეულებრივ ობიექტებს, არა Eloquent მოდელებს). ის chainable-ია და **ავტომატურად იყენებს პარამეტრის binding-ს** — SQL ინჯექციის შემოწმება.

## Eloquent იყენებს იგივე 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.)
```

თუ chain-ს გააკეთებთ მეთოდებზე Eloquent მოდელზე, თქვენ იყენებთ Query Builder-ს ქვეშ — მაგრამ თქვენ დაბრუნდებით **მოდელებს** (ურთიერთობებით, accessor-ებით, და მეთოდებით) ჩვეულებრივი ობიექტების ნაცვლად.

## მოწინავე მოთხოვნები (ორივე მხარდაჭერილია)

```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-ს, aggregate-ებს, subqueries-ს და კომპლექსურ პირობებს.

## რომელი გამოიყენოთ

```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-ში მონაცემთა ბაზებთან ეფექტურად მუშაობისთვის და თითოეული სიტუაციისთვის სწორი ხელსაწყოს არჩევისთვის.

მთავარი შეხედულება ის არის, რომ **Eloquent აგებულია Query Builder-ზე** — ამიტომ fluent, chainable მეთოდები, რომელსაც იყენებთ Eloquent მოდელებზე (`where`, `orderBy`, `join` და ა.შ.), არის Query Builder-ის, რაც ნიშნავს, რომ ერთის სწავლა ორივეს სწავლის სხვა გზა.

Query Builder უზრუნველყოფს სუფთა, SQL-ინჯექციის უსაფრთხო (ავტომატური პარამეტრის binding-ის მეშვეობით) გზას მოთხოვნების აგებისთვის ხელმისაწვდომი SQL-ის გარეშე, და Eloquent ზეწოვებს მოდელის ფუნქციონალურობას (ურთიერთობები, accessor-ები, მეთოდები).

**რომელი გამოიყენოთ** არის პრაქტიკული უნარი: **Eloquent** უმეტეს აპლიკაციის ლოგიკისთვის (თქვენ მიიღებთ მდიდარ მოდელ ობიექტებს ურთიერთობებითა და ქცევით), და **Query Builder პირდაპირი** (`DB::table`) მსუბუქი მოთხოვნებისთვის მოდელის ზეწოვების გარეშე, რთული ანგარიშებისთვის/aggregation-ებისთვის, ან როდესაც არ გჭირდებათ სრული მოდელები — რაც უფრო ეფექტური შეიძლება იყოს გარკვეული შემთხვევების დროს.

ორივე უსაფრთხოდ უმკლავდება რთულ მოთხოვნებს (joins, aggregates, subqueries) იგივე fluent API-ით.

Query Builder-ის, როგორ აიგო ის Eloquent-ზე, გაზიარებული უსაფრთხო პარამეტრის binding-ის (SQL ინჯექციის შემოწმება), და მათ შორის არჩევანის გაგება მნიშვნელოვანი ცოდნაა Laravel-ში ეფექტური, უსაფრთხო მონაცემთა ბაზის კოდის დასაწერად, რადგან მონაცემთა ბაზის დაშვებაა ცენტრალური უმეტეს აპლიკაციებში და სწორი დონის არჩევანი (მოდელი-მდიდარი Eloquent მდელ მსუბუქი Query Builder) გავლენას ახდენს სიცხადეზე და მუშაობის უნარზე.