آموزش جامع مدل‌ها و Eloquent ORM در لاراول

namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
    // نام جدول مربوط به این مدل
    protected $table = 'users';
    // فیلدهای قابل پر شدن (Mass Assignment)
    protected $fillable = ['name', 'email', 'password'];
    // فیلدهای مخفی شده (مثلاً پسورد)
    protected $hidden = ['password', 'remember_token'];
}

php artisan make:model Post -m

// ایجاد یک پست جدید
$post = Post::create([
    'title' => 'اولین پست من',
    'body' => 'این محتوای اولین پست من است.',
    'published_at' => now()
]);
// دریافت تمام پست‌های منتشر شده
$publishedPosts = Post::where('published_at', '<=', now())
    ->orderBy('published_at', 'desc')
    ->get();

// در مدل User
public function posts()
{
    return $this->hasMany(Post::class);
}
// در مدل Post
public function user()
{
    return $this->belongsTo(User::class);
}

// در مدل Post
public function tags()
{
    return $this->belongsToMany(Tag::class);
}
// در مدل Tag
public function posts()
{
    return $this->belongsToMany(Post::class);
}

// در مدل User
public function profile()
{
    return $this->hasOne(Profile::class);
}
// در مدل Profile
public function user()
{
    return $this->belongsTo(User::class);
}

// تعریف scope در مدل Post
public function scopePublished($query)
{
    return $query->where('published_at', '<=', now());
}
// استفاده از scope
$publishedPosts = Post::published()->get();

// Accessor - وقتی مقدار فیلد را می‌خوانید
public function getTitleAttribute($value)
{
    return ucfirst($value);
}
// Mutator - وقتی مقدار فیلد را ست می‌کنید
public function setTitleAttribute($value)
{
    $this->attributes['title'] = strtolower($value);
}

// ایجاد پست با عنوان "Hello World"
$post = Post::create(['title' => 'Hello World']);
// در دیتابیس ذخیره می‌شود: 'hello world'
// هنگام خواندن نمایش داده می‌شود: 'Hello world'

// روش اول
$post = new Post();
$post->title = 'عنوان پست';
$post->body = 'متن پست';
$post->save();
// روش دوم (Mass Assignment)
$post = Post::create([
    'title' => 'عنوان پست',
    'body' => 'متن پست'
]);

// دریافت تمام رکوردها
$posts = Post::all();
// دریافت یک رکورد با id
$post = Post::find(1);
// دریافت اولین رکورد مطابق شرط
$post = Post::where('published', true)->first();

// روش اول
$post = Post::find(1);
$post->title = 'عنوان جدید';
$post->save();
// روش دوم (Mass Assignment)
Post::where('id', 1)->update(['title' => 'عنوان جدید']);

// روش اول
$post = Post::find(1);
$post->delete();
// روش دوم
Post::destroy(1);
// روش سوم (حذف چند رکورد)
Post::where('published', false)->delete();

class Product extends Model
{
    // فیلدهای قابل پر شدن
    protected $fillable = ['name', 'price', 'stock'];
    // رابطه با مدل Category (هر محصول یک دسته‌بندی دارد)
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
    // Scope برای دریافت محصولات موجود
    public function scopeAvailable($query)
    {
        return $query->where('stock', '>', 0);
    }
    // Accessor برای نمایش قیمت با فرمت مناسب
    public function getFormattedPriceAttribute()
    {
        return number_format($this->price) . ' تومان';
    }
}