რა არის Eloquent და როგორ იყენებთ მოდელებს?

Question

Accepted Answer

**Eloquent** არის Laravel-ის ORM (Object-Relational Mapper) — იგი იყენებს **Active Record** ნიმუშს, სადაც თითოეული მონაცემთა ბაზის ცხრილს აქვს შესაბამისი **Model** კლასი, ხოლო მოდელის ინსტანციები წარმოადგენენ რიგებს. ის უზრუნველყოფს ელეგანტურ, გამოხატულ გზას მონაცემთა ბაზის შთხოვნისა და მანიპულირებისთვის SQL-ის დაწერის გარეშე.

## მოდელის განსაზღვრა

```php
<?php
class User extends Model {
    // by convention, the User model maps to the "users" table automatically
    protected $fillable = ['name', 'email'];   // mass-assignable fields (security)
}
// generate with: php artisan make:model User
```

მოდელი ვრცელდება `Model`-ზე და რუკა ცხრილით დასახელების კონვენციით (`User` → `users`). `$fillable` სია აკონტროლებს რომელი ველი შეიძლება მასობრივად მიენიჭოს (უსაფრთხოების ფუნქცია).

## CRUD ოპერაციები (Active Record)

```php
// CREATE
$user = User::create(['name' => 'Ann', 'email' => 'ann@x.com']);
$user = new User; $user->name = 'Bob'; $user->save();

// READ
User::all();                              // all rows
User::find(1);                            // by primary key
User::where('active', true)->get();        // query with conditions
User::where('email', $email)->first();     // first match

// UPDATE
$user->update(['name' => 'New Name']);
$user->name = 'X'; $user->save();

// DELETE
$user->delete();
User::destroy(1);
```

Eloquent-ის სიმფონიური, ჯაჭვისებური API თითქმის ინგლისური ენის მსგავსად იკითხება და SQL აყალიბებს თქვენთვის — არ არის ხელმუხლები საერთო ოპერაციებისთვის.

## შთხოვნა fluent builder-ით

```php
User::where('age', '>', 18)
    ->where('active', true)
    ->orderBy('name')
    ->limit(10)
    ->get();                              // chainable query building

User::where('role', 'admin')->count();
User::where('email', $e)->exists();
```

## მოდელები მონაცემებზე მეტი არის

```php
class Post extends Model {
    public function author() {                          // a relationship
        return $this->belongsTo(User::class);
    }
    public function getExcerptAttribute() {              // an accessor (computed attribute)
        return Str::limit($this->body, 100);
    }
}
$post->author;       // the related User
$post->excerpt;       // computed attribute
```

## რატომ არის ეს მნიშვნელოვანი

Eloquent არის Laravel-ის ცენტრი — ეს არის როგორ ითქვამია აპლიკაციები მონაცემთა ბაზასთან, და მისი ელეგანტური Active Record დიზაინი არის ფრეიმვორკის ყველაზე დაფასებული ფუნქციებიდან ერთი, ამიტომ მისი დაუფლება აუცილებელია ნებისმიერი Laravel განვითარებისთვის.

მოდელის განსაზღვრის გაგება (რუკა ცხრილებით კონვენციით), CRUD ოპერაციების შესრულება და fluent, ჯაჭვისებური builder-ით შთხოვნა ყოველდღიური, ფუნდამენტური ცოდნა მას შემდეგ, რაც მონაცემთა წვდომა ყველაზე აპლიკაციის ბირთვი.

Eloquent-ის გამოხატული, წაკითხვადი API (`User::where(...)->orderBy(...)->get()`) საშუალებას გაძლევთ მონაცემთა ბაზასთან მუშაობა სუფთა PHP-ში SQL დაწერის გარეშე, რაც მკაცრად გაზრდის პროდუქტიულობას და წაკითხვადობას.

მოდელები ასევე მონაცემთა კონტეინერებზე მეტი — ისინი განსაზღვრავენ **ურთიერთობებს** (დაკავშირებული ცხრილების დაკავშირება) და შეიძლება ჰქონდეთ **დამატებები/მუტატორები** (გამოთვლილი ატრიბუტები) და ბიზნეს-ლოგიკა, მათი მდიდარი დომენის ობიექტებად გარდაქმნა.

`$fillable` მასობრივი-დანიშვების დაცვის (უსაფრთხოების მოსაზრება) ცოდნა ასევე მნიშვნელოვანია.

მას შემდეგ, რაც Eloquent არის როგორ Laravel აპლიკაციები კითხვენ და წერენ მათ მონაცემებს — და ეს ჩნდება პრაქტიკულად ყველა Laravel აპში — მოდელებისა და Eloquent-ის შთხოვნის API-ის დაუფლება ფუნდამენტური, უნდა-იცოდა მასალა რომელიც 支持 ეფექტური Laravel განვითარება.