📊 مدل‌ها در لاراول

مدل‌ها در لاراول به عنوان نماینده‌ای از جداول پایگاه داده عمل می‌کنند و به شما این امکان را می‌دهند که با داده‌ها به‌صورت ساده و با استفاده از Eloquent ORM کار کنید. در این مقاله، روش‌های مختلف استفاده از مدل‌ها، عملیات پایه‌ای و روابط بین مدل‌ها را بررسی خواهیم کرد.

1. 🛠 تعریف مدل در لاراول

برای تعریف یک مدل در لاراول، می‌توانید از دستور artisan make:model استفاده کنید. به عنوان مثال، برای ایجاد مدل Post، دستور زیر را اجرا کنید:

bash
CopyEdit
php artisan make:model Post

این دستور یک کلاس مدل به نام Post در پوشه app/Models ایجاد می‌کند.

2. 🏷 اتصال مدل‌ها به جداول پایگاه داده

لاراول به طور پیش‌فرض نام جدول را از مدل شما به صورت جمع به‌دست می‌آورد. برای مثال، مدل Post به طور پیش‌فرض به جدول posts متصل می‌شود. اگر نام جدول شما متفاوت باشد، می‌توانید آن را در مدل مشخص کنید:

php
CopyEdit
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $table = 'custom_table_name';
}

3. ⚙️ ویژگی‌های مدل در لاراول

برای کنترل ویژگی‌های مدل، می‌توانید از ویژگی‌های مختلف مانند fillable، guarded و timestamps استفاده کنید.

ویژگی‌های پرشده ($fillable):

این ویژگی تعیین می‌کند که کدام فیلدها می‌توانند به‌طور جمعی پر شوند.

php
CopyEdit
protected $fillable = ['title', 'content'];

ویژگی‌های محافظت‌شده ($guarded):

این ویژگی فیلدهایی را که نمی‌توانند به‌طور جمعی پر شوند مشخص می‌کند.

php
CopyEdit
protected $guarded = ['id'];

تایم‌استمپ‌ها ($timestamps):

اگر می‌خواهید از تایم‌استمپ‌ها (مثل created_at و updated_at) استفاده نکنید، می‌توانید آن‌ها را غیرفعال کنید.

php
CopyEdit
public $timestamps = false;

4. 🔄 عملیات پایه‌ای با مدل‌ها

ذخیره داده‌ها

برای ذخیره داده‌ها در مدل، می‌توانید از متد save() استفاده کنید:

php
CopyEdit
$post = new Post;
$post->title = 'My First Post';
$post->content = 'Content of my first post.';
$post->save();

به‌روزرسانی داده‌ها

برای به‌روزرسانی داده‌ها:

php
CopyEdit
$post = Post::find(1);
$post->title = 'Updated Title';
$post->save();

حذف داده‌ها

برای حذف داده‌ها:

php
CopyEdit
$post = Post::find(1);
$post->delete();

5. 📈 عملیات پیشرفته با Eloquent

لاراول اجازه می‌دهد تا پرس‌وجوهای پیچیده‌تری با استفاده از Eloquent ORM انجام دهید.

جستجو با شرایط

php
CopyEdit
$posts = Post::where('title', 'like', '%First%')->get();

مرتب‌سازی داده‌ها

php
CopyEdit
$posts = Post::orderBy('created_at', 'desc')->get();

استفاده از شرط‌های مختلف

php
CopyEdit
$posts = Post::where('status', 'published')
             ->where('created_at', '>', '2025-01-01')
             ->get();

گرفتن یک نتیجه

php
CopyEdit
$post = Post::find(1); // پست با ID برابر با 1

6. 🔗 روابط بین مدل‌ها

لاراول روابط مختلفی را بین مدل‌ها پشتیبانی می‌کند. این روابط شامل یک به یک (One-to-One)، یک به چند (One-to-Many) و چند به چند (Many-to-Many) هستند.

رابطه یک به یک (One-to-One)

در مدل User:

php
CopyEdit
public function profile()
{
    return $this->hasOne(Profile::class);
}

در مدل Profile:

php
CopyEdit
public function user()
{
    return $this->belongsTo(User::class);
}

رابطه یک به چند (One-to-Many)

در مدل Post:

php
CopyEdit
public function comments()
{
    return $this->hasMany(Comment::class);
}

در مدل Comment:

php
CopyEdit
public function post()
{
    return $this->belongsTo(Post::class);
}

رابطه چند به چند (Many-to-Many)

در مدل Student:

php
CopyEdit
public function courses()
{
    return $this->belongsToMany(Course::class);
}

در مدل Course:

php
CopyEdit
public function students()
{
    return $this->belongsToMany(Student::class);
}

7. 🔎 استفاده از Scope‌ها

Scope‌ها در لاراول به شما این امکان را می‌دهند که فیلترهای قابل استفاده مجدد برای مدل‌ها ایجاد کنید. به عنوان مثال، یک scope برای جستجوی پست‌های منتشر شده:

php
CopyEdit
public function scopePublished(Builder $query)
{
    return $query->where('status', 'published');
}

سپس می‌توانید از این scope در پرس‌وجوها استفاده کنید:

php
CopyEdit
$posts = Post::published()->get();

نتیجه‌گیری

مدل‌ها در لاراول به شما این امکان را می‌دهند که به‌راحتی با پایگاه داده تعامل داشته باشید. با استفاده از Eloquent ORM می‌توانید عملیات CRUD را به ساده‌ترین شکل ممکن انجام دهید و روابط پیچیده بین جداول را به راحتی مدیریت کنید.