🎯 الگوی 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

🛠 گام‌به‌گام پیاده‌سازی الگوی 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

📚 احراز هویت در Laravel Sanctum

در توسعه API با لاراول، نیاز داریم تا کاربران را احراز هویت (Authentication) کنیم تا فقط کاربران مجاز به برخی بخش‌های سیستم دسترسی داشته باشند. یکی از روش‌های محبوب برای این کار، استفاده از Laravel Sanctum است که با تولید توکن‌های منحصربه‌فرد این کار را انجام می‌دهد.

در این درس، با فرآیند ثبت‌نام، ورود، خروج، و نحوه کارکرد Bearer Token در Sanctum آشنا می‌شویم.

1️⃣ ثبت‌نام و دریافت توکن (Register)

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

🔹 مثال کد در لاراول:

public function register(Request $request)
{
    $fields = $request->validate([
        'name'     => 'required|string|max:255',
        'email'    => 'required|string|email|max:255|unique:users',
        'password' => 'required|string|min:8|confirmed',
    ]);

    $user = User::create([
        'name'     => $fields['name'],
        'email'    => $fields['email'],
        'password' => Hash::make($fields['password']),
    ]);

    $token = $user->createToken($user->name);

    return [
        'user'  => $user,
        'token' => $token->plainTextToken,
    ];
}

🔹 چرا createToken اینجا استفاده شده؟

چون بعد از ثبت‌نام، باید یک توکن برای کاربر صادر کنیم تا بلافاصله بتواند از API استفاده کند.

2️⃣ ورود و دریافت توکن جدید (Login)

🔹 وقتی کاربر وارد سیستممی‌شود، سیستم ایمیل و رمز عبور او را بررسی می‌کند. اگر اطلاعات صحیح بود، یک توکن جدید برای او صادر می‌شود.

🔹 مثال کد در لاراول:

public function login(Request $request)
{
    $fields = $request->validate([
        'email'    => 'required|string|email|max:255|exists:users',
        'password' => 'required|string|min:8',
    ]);

    $user = User::where('email', $fields['email'])->first();

    if (!$user || !Hash::check($fields['password'], $user->password)) {
        return response([
            'message' => 'Invalid credentials',
        ], 401);
    }

    $token = $user->createToken($user->name);

    return [
        'user'  => $user,
        'token' => $token->plainTextToken,
    ];
}

🔹 چرا باز هم createToken داریم؟

چون هر بار که کاربر وارد سیستم می‌شود، یک توکن جدید برای او صادر می‌کنیم تا در درخواست‌های بعدی از آن استفاده کند.


3️⃣ احراز هویت و ارسال توکن در درخواست‌ها

🔹 بعد از ورود موفق، کاربر باید توکن خود را در هدر درخواست‌ها بفرستد تا بتواند از API استفاده کند.

🔹 مثال درخواست به یک مسیر محافظت‌شده:

GET /api/user
Authorization: Bearer your_token_here

🔹 و اما Bearer Token چیست؟

- این توکن مانند یک کارت عضویت است که نشان می‌دهد کاربر وارد سیستم شده است.
- اگر این کارت نداشته باشد، اجازه دسترسی به بخش‌های محافظت‌شده API را نخواهد داشت.


4️⃣ خروج و حذف توکن (Logout)

🔹 وقتی کاربر از حساب خود خارج شود، باید توکن‌های او حذف شوند تا دیگر امکان استفاده از API نداشته باشد.

🔹 مثال کد در لاراول:

public function logout(Request $request)
{
    $request->user()->tokens()->delete();

    return [
        'message' => 'Logged out',
    ];
}

🔹 چرا tokens()->delete استفاده شده؟

چون باید تمام توکن‌های کاربر را پاک کنیم تا دیگر نتواند از API استفاده کند.


5️⃣ چرا در مسیر logout از Middleware auth:sanctum استفاده شده؟

🔹 در مسیرهای حساس (مثل logout)، باید حتماً بررسی کنیم که کاربر احراز هویت شده باشد.

🔹 این کار را Middleware auth:sanctum انجام می‌دهد.

🔹 تعریف مسیرها در routes/api.php

Route::post('/register', [AuthController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);
Route::post('/logout', [AuthController::class, 'logout'])->middleware('auth:sanctum');

🔹 چرا فقط برای logout این middleware اضافه شده؟

میدانیم که خروج از سیستم (logout) فقط باید توسط یک کاربری که لاگین کرده و توکن معتبر داره انجام بشه. یعنی کسی که هنوز توکن نگرفته نباید بتونه logout کنه! 🤨

این میان‌افزار (Middleware) باعث می‌شه که لاراول بررسی کنه آیا این درخواست واقعاً از طرف یک کاربر احراز هویت‌شده هست یا نه.

✅ اگر کاربر توکن معتبر داشته باشه → درخواست قبول می‌شه و توکنش پاک می‌شه.

❌ اگر توکن نداشته باشه یا جعلی باشه → لاراول خطای ۴۰۱ (Unauthorized) برمی‌گردونه.



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

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

✨ شرکت OpenAI امروز یک سری ابزار هیجان‌انگیز منتشر کرده که ساختن «ایجنت‌ها» (برنامه‌های هوشمند) را برای برنامه‌نویسان ساده‌تر از همیشه می‌کند!

🧐 حالا «ایجنت» دقیقاً چیه؟

یک «ایجنت» برنامه هوشمندی است که خودش و بدون دخالت انسان کارهایی مثل جواب دادن به ایمیل‌ها، جستجوی سریع و دقیق در اینترنت یا فایل‌ها و مدیریت هوشمندانه‌ی کارها را انجام می‌دهد.

✨ OpenAI امروز سه ابزار جدید برای راحت کردن ساخت این ایجنت‌ها معرفی کرده:


🔸Web Search
🔹File Search
🔸Agents SDK


👇 برای خواندن توضیح کامل این ابزارهای جدید و جذاب، حتماً این پست رو بخون...

🔗 اینجا ....


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

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

سلام رفقا! 👋😊

تو سال جدید قراره توی اون یکی کانالمون حسابی درباره هوش مصنوعی صحبت کنیم!
از پرامپت‌نویسی گرفته تا معرفی ابزارهای خفن این حوزه! 🤖🔥

اگه به این دنیا علاقه دارید، حتماً بهمون ملحق بشید و توی بحث‌ها شرکت کنید!
منتظرتون هستیم اون طرف! 😍👇

🔗 لینک کانال

سال نو مبارک رفقا
سالی باشه از حال خوب، برکت و روزی فراوان و در هر مسیری که براش در تلاش هستید بهترین ها براتون پیش بیاد و موفقیت باشه ❤️🪻

🔥 پکیج جذاب Toast برای لاراول – معرفی Laravel Toaster Magic

اگه دنبال یه راه ساده، سریع و شیک برای نشون دادن پیام‌های toast توی پروژه‌هات با Laravel هستی، این پکیج دقیقاً همون چیزیه که لازم داری!

✨ یه پکیج سبک و قوی برای ایجاد toast نوتیفیکیشن توی اپلیکیشن‌های Laravel هستش

🚀 ویژگی‌های جالب این پکیج:

- استفاده‌ی ساده و مستقیم داخل Laravel
- پشتیبانی کامل از زبان‌های راست‌به‌چپ مثل فارسی 🇮🇷
- حالت تاریک برای هماهنگی با UI تاریک 🌑
- پیام‌های toast کاملاً قابل شخصی‌سازی و قابل تنظیم به دلخواه شما 🎯

🛠 چطور نصبش کنیم؟

خیلی راحت! فقط چند خط کده:

1️⃣ نصب با Composer:

composer require devrabiul/laravel-toaster-magic

2️⃣ منتشر کردن فایل‌های پکیج:

php artisan vendor:publish --provider="Devrabiul\ToastMagic\ToastMagicServiceProvider"

3️⃣ اضافه کردن استایل‌ها و اسکریپت‌ها در فایل Blade:

<!DOCTYPE html>
<html lang="en">
<head>
    {!! ToastMagic::styles() !!}
</head>
<body>
    // محتوای شما

    {!! ToastMagic::scripts() !!}
</body>
</html>

🎯 چطور toast نمایش بدیم؟

توی متدهای Controller به همین راحتی:

use Devrabiul\ToastMagic\Facades\ToastMagic;

class TeamController extends Controller
{
    public function store()
    {
        ToastMagic::success('Team added successfully!');
        return redirect('/teams');
    }
}

📌 همچنین می‌تونی از toastهای دیگه مثل:

- ⚠️ warning
- ❌ error
- ℹ️ info

استفاده کنی.

💻 Toast از طریق JavaScript

اگر خواستی toast رو مستقیم از JS اجرا کنی:

const toast = new ToastMagic();
toast.success("Success!", "Your data has been saved!");

---

📚 برای اطلاعات بیشتر یا دیدن سورس‌کدش:

🔗 Link





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

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

✨ فصل اول دوره کامل شد!

اگه همیشه برات سوال بوده که هوش مصنوعی چیه و چطور کار می‌کنه، این فصل دقیقاً برای توئه!

توی این فصل، همه‌چی رو ساده، قابل فهم و بدون پیچیدگی توضیح دادم:

💡 درک اولیه از AI
🕰 تاریخچه‌ی هوش مصنوعی
🧠 مفاهیم پایه‌ای و مهم
⚙️ طرز فکر کردن هوش مصنوعی
🔧 مدل‌ها و پارامترها

مهم نیست مبتدی باشی یا فقط کنجکاوی — این ویدیوها برای همه طراحی شدن تا از یادگیری لذت ببرند! 😊


▶️ لینک دسترسی به دوره

https://youtu.be/pKQDvl34N7E?si=YuqOAXEKFvbS0Raj



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

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

سیر تا پیاز Codex: دستیار هوش مصنوعی که کدنویسی رو متحول می‌کنه!

🔗 مطالعه این مطلب در اینجا 👉

🔐 ورود بدون رمز عبور با Passkeys در لاراول!
توسط Spatie

آیا دوست داری کاربران سایتت بدون وارد کردن ایمیل و رمز عبور وارد بشن؟ فقط با یه تأیید ساده از طریق موبایل یا مرورگر؟

💡 پکیج Laravel Passkeys از تیم معروف Spatie که این کار رو توی اپلیکیشن‌های لاراول خیلی راحت و حرفه‌ای انجام می‌ده.

🎯 چیه اصلاً Passkey؟

یه کلید امنه که توی ابزارهایی مثل:

- 1Password
- مدیریت رمز عبور در macOS
- و سایر اپ‌های رمزنگاری‌شده

ذخیره می‌شه. وقتی از Passkey استفاده می‌کنی، دیگه لازم نیست ایمیل یا پسورد بزنی؛ فقط با یک کلیک یا اثر انگشت یا Face ID وارد می‌شی. ✨


⚙️ این پکیج چه کاری می‌کنه؟

این پکیج بهت اجازه می‌ده:

🔹 به‌راحتی برای کاربر Passkey بسازی
🔸 سیستم ورود بدون رمز عبور رو در برنامه‌ت فعال کنی.
🔹 با استفاده از کامپوننت‌های Livewire یا Blade این سیستم رو پیاده‌سازی کنی

⚒️ پشتیبانی از Livewire و Inertia

در حال حاضر، این پکیج به‌صورت پیش‌فرض با Livewire کار می‌کنه، ولی اگر از Inertia استفاده می‌کنی، می‌تونی خودت یه کامپوننت سفارشی با React یا Vue بسازی.

📘 برای این مورد، صفحه‌ی "Usage in Inertia" توی داکیومنتش رو حتماً ببین!

🚀 شروع کار با Passkeys

📦 سورس کد این پکیج در گیت‌هاب منتشر شده:

🔗 لینک اینجا

📚 توی مستنداتش می‌تونی قدم‌به‌قدم یاد بگیری چطور نصبش کنی و ازش استفاده ببری.

حتی یه اپلیکیشن دمو هم ساختن تا بتونی این سیستم رو به‌صورت واقعی ببینی و تست کنی.

📌 نتیجه‌گیری کوتاه

اگه دنبال راهی امن‌تر، سریع‌تر و مدرن‌تر برای ورود کاربران هستی، بدون شک Passkeys یه انتخاب فوق‌العاده‌ست برای اپلیکیشن‌های لاراولی — مخصوصاً اگه تجربه‌ی کار با پکیج‌های Spatie رو داشته باشی، می‌دونی چقدر تمیز و استاندارد کار می‌کنن.


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

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