کانال آموزشی لاراول

کانال آموزشی لاراول pinned «🎯 الگوی Service Repository Pattern در Laravel ✨مقدمه در دنیای برنامه‌نویسی کد تمیز و قابل نگهداری یک اصل مهم است. Laravel به صورت پیش‌فرض از Active Record Pattern استفاده می‌کند که در پروژه‌های کوچک کارآمد است، اما در پروژه‌های بزرگ باعث کنترلرهای چاق و…»

🛠 گام‌به‌گام پیاده‌سازی الگوی Service Repository Pattern در Laravel

1️⃣ ایجاد Repository (مدیریت دیتابیس)

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

namespace App\Repositories;
use App\Models\Post;
use Illuminate\Support\Collection;

interface PostRepositoryInterface {
    public function getAll(): Collection;
    public function findById(int $id): ?Post;
    public function create(array $data): Post;
}

🔹 سپس کلاس پیاده‌سازی آن را می‌نویسیم:

namespace App\Repositories;
use App\Models\Post;
use Illuminate\Support\Collection;

class PostRepository implements PostRepositoryInterface {
    public function getAll(): Collection {
        return Post::all();
    }

    public function findById(int $id): ?Post {
        return Post::find($id);
    }

    public function create(array $data): Post {
        return Post::create($data);
    }
}

🚀 حالا لایه دیتابیس در PostRepository قرار دارد و کنترلرها مستقیماً به مدل دسترسی ندارند.


2️⃣ ایجاد Service (مدیریت منطق تجاری)

کلاس PostService را می‌سازیم و وابستگی‌های آن را تزریق می‌کنیم:

namespace App\Services;
use App\Repositories\PostRepositoryInterface;
use Illuminate\Support\Collection;
use App\Models\Post;

class PostService {
    protected $postRepo;

    public function __construct(PostRepositoryInterface $postRepo) {
        $this->postRepo = $postRepo;
    }

    public function listPosts(): Collection {
        return $this->postRepo->getAll();
    }

    public function getPostDetails(int $id): ?Post {
        return $this->postRepo->findById($id);
    }

    public function createPost(array $data): Post {
        return $this->postRepo->create($data);
    }
}

🔹 حالا سرویس‌ها از ریپازیتوری برای دریافت داده استفاده می‌کنند و هرگونه منطق تجاری مثل بررسی قوانین، ارسال اعلان و... را در خود دارند.


3️⃣ استفاده از این الگو در Controller

🔹 کنترلر را طوری می‌نویسیم که فقط از PostService استفاده کند:

namespace App\Http\Controllers;
use App\Services\PostService;
use Illuminate\Http\Request;

class PostController extends Controller {
    protected $postService;

    public function __construct(PostService $postService) {
        $this->postService = $postService;
    }

    public function index() {
        $posts = $this->postService->listPosts();
        return view('posts.index', compact('posts'));
    }

    public function show($id) {
        $post = $this->postService->getPostDetails($id);
        return view('posts.show', compact('post'));
    }

    public function store(Request $request) {
        $data = $request->validate([ 'title' => 'required', 'content' => 'required' ]);
        $post = $this->postService->createPost($data);
        return redirect()->route('posts.show', $post->id);
    }
}

🚀 کنترلر فقط درخواست‌ها را مدیریت می‌کند و تمام کارها را به سرویس‌ها می‌سپارد!


4️⃣ ثبت Dependency Injection در Laravel

برای این‌که Laravel متوجه شود که PostRepositoryInterface باید PostRepository را برگرداند، باید آن را در Service Provider ثبت کنیم:

use App\Repositories\PostRepositoryInterface;
use App\Repositories\PostRepository;

public function register() {
    $this->app->bind(PostRepositoryInterface::class, PostRepository::class);
}

✅ حالا هر جا PostRepositoryInterface نیاز باشد، Laravel خودش PostRepository را جایگزین می‌کند!


🎯 مزایای نهایی این الگو

🚀 کد خواناتر و ساختاریافته
🔧 افزایش قابلیت تست‌نویسی
⚡️ امکان توسعه و تغییر آسان
💡 تفکیک کامل لایه‌ها برای مدیریت بهتر کد

اگر پروژه‌ی شما بزرگ است و می‌خواهید بهترین معماری را برای کدهایتان داشته باشید، Service Repository Pattern یک راه‌حل عالی است! 🔥



✅ کانال تخصصی لاراول
📌 @PapiDon_state

☕️ اتاق برنامه‌نویسی
📌 @PapiDon_coding

🎯 الگوی Service Repository Pattern در Laravel

✨مقدمه

در دنیای برنامه‌نویسی کد تمیز و قابل نگهداری یک اصل مهم است. Laravel به صورت پیش‌فرض از Active Record Pattern استفاده می‌کند که در پروژه‌های کوچک کارآمد است، اما در پروژه‌های بزرگ باعث کنترلرهای چاق و پیچیده می‌شود.

🧐 راه‌حل چیست؟

الگوی Service Repository Pattern

🔸 این الگو دسترسی به داده‌ها و منطق تجاری را از هم جدا می‌کند تا:

✔️ کد خواناتر شود
✔️ قابلیت تست‌نویسی بالا برود
✔️ توسعه و تغییرات آینده راحت‌تر باشد
✔️ کنترلرهای سبک‌تر شوند

🔹ریپازیتوری (Repository): تنها وظیفه‌ی تعامل با دیتابیس را دارد.

🔹سرویس (Service): منطق تجاری (Business Logic) را مدیریت می‌کند.

🔹کنترلر (Controller): فقط نقش هماهنگ‌کننده را دارد و درخواست‌ها را به سرویس‌ها ارسال می‌کند.

⚜️چرا از Service Repository استفاده کنیم؟

💡مشکلات روش معمول (بدون این الگو):

🚫 کدهای تکراری در کنترلرها

🚫 سخت شدن تست‌نویسی

🚫 کنترلرهای چاق و نامرتب

🚫 تغییرات سخت در آینده

🔄 مزایای این الگو:

1️⃣ افزایش خوانایی و نگهداری‌پذیری

2️⃣ ماژولار شدن کد و امکان توسعه‌ی آسان

3️⃣ امکان تست‌نویسی جداگانه برای هر لایه

4️⃣ امکان تغییر منبع داده بدون نیاز به تغییر منطق سرویس‌ها



✅ کانال تخصصی لاراول
📌 @PapiDon_state

☕️ اتاق برنامه‌نویسی
📌 @PapiDon_coding

✨ آشنایی با Macro‌ها در Laravel

🧐 اصلا Macro چیست و چرا استفاده می‌شود؟

روشی برای افزودن پویا (در زمان اجرا) متدهای جدید به کلاس‌های داخلی فریم‌ورک است، بدون اینکه نیاز باشد آن کلاس را ویرایش کنیم یا از آن ارث‌بری کنیم​.

این قابلیت به کمک تریت ویژه‌ای به نام Macroable فراهم می‌شود که در بسیاری از کلاس‌های هسته‌ی لاراول به‌کار رفته است (مثلاً در کلاس‌های Response, Collection, Str و... که اجازه می‌دهند متدهای جدید به آنها اضافه شود)​

به زبان ساده، Macro به ما امکان می‌دهد عملکردهای دلخواه خود را به کلاس‌هایی که مالکیتشان در اختیار ما نیست اضافه کنیم. تمامی نمونه‌های آن کلاس (و حتی خود کلاس به صورت استاتیک) پس از تعریف یک ماکرو، می‌توانند متد جدید را صدا بزنند که گویی از ابتدا جزئی از کلاس بوده است​.

🤓 چرا باید از Macro استفاده کنیم؟

اولین دلیل، سادگی آن نسبت به روش‌های سنتی است. افزودن یک قابلیت کوچک با ماکرو بسیار راحت‌تر از ایجاد یک زیرکلاس و جایگزین‌کردن آن به‌جای کلاس اصلی است​.

با یک فراخوانی، متد دلخواه اضافه می‌شود و نیازی به تغییر دیگر قسمت‌های کد نیست. دلیل دوم، تمیز ماندن کدهای هسته‌ی لاراول است؛ با ماکروها می‌توانیم بدون دست بردن در کد اصلی فریم‌ورک، آزادی عمل خود را حفظ کنیم​.

هر قابلیت کمبود کوچکی (مثلاً متدی که احساس می‌کنید در کلاس Collection یا Response کم است) را می‌توان با یک ماکرو جبران کرد. همچنین ماکروها به ما کمک می‌کنند از تکرار کدهای مشابه در بخش‌های مختلف جلوگیری کنیم و منطق مشترک را در یک محل مرکزی (ماکرو) قرار دهیم​.

بنابراین خوانایی کد افزایش یافته و نگهداری آن ساده‌تر می‌شود. به طور خلاصه، ماکروها یک راهکار سریع برای گسترش امکانات کلاس‌های لاراول هستند که زمانی استفاده می‌شوند که احساس کنیم نبود یک متد خاص کار ما را سخت و کدمان را شلوغ کرده است​.




✅ کانال تخصصی لاراول
📌 @PapiDon_state

☕️ اتاق برنامه‌نویسی
📌 @PapiDon_coding