ما هو Eloquent وكيف تستخدم النماذج؟

Question

Accepted Answer

**Eloquent** هو ORM (Object-Relational Mapper) في Laravel — يستخدم نمط **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);
```

API Eloquent السلس والقابل للربط يُقرأ تقريباً مثل الإنجليزية وينشئ SQL من أجلك — لا حاجة للاستعلامات الخام في العمليات الشائعة.

## الاستعلام باستخدام محرر البناء السلس

```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 والاستعلام باستخدام محرر البناء السلس والقابل للربط هو معرفة أساسية وروتينية لأن الوصول إلى البيانات هو جوهر معظم التطبيقات.

API Eloquent التعبيري والقابل للقراءة (`User::where(...)->orderBy(...)->get()`) يسمح لك بالعمل مع قاعدة البيانات في PHP النظيف دون كتابة SQL، مما يحسن الإنتاجية والقراءة بشكل كبير.

النماذج أيضاً أكثر من مجرد حاويات بيانات — تحدد **العلاقات** (ربط الجداول ذات الصلة) وقد يكون لها **المُتقبلات/المُحدثات** (الخصائص المحسوبة) والمنطق التجاري، مما يجعلها كائنات مجال غنية.

معرفة حماية تعيين الكتلة `$fillable` (اعتبار أمان) مهمة أيضاً.

بما أن Eloquent هي طريقة تطبيقات Laravel في قراءة وكتابة بياناتها — وتظهر في جميع تطبيقات Laravel تقريباً — فإن إتقان النماذج و API استعلام Eloquent هو مادة أساسية وحتمية الذي يدعم تطوير Laravel الفعال.