📜 پیام‌های فلش (Flash Messages) لاراول

پیام‌های فلش در لاراول ابزاری مفید برای ارسال پیام‌های موقت به کاربران هستند که به‌طور معمول بعد از یک عملیات موفق یا ناموفق (مانند ثبت‌نام، ورود به سیستم یا ارسال فرم) نمایش داده می‌شوند. این پیام‌ها بعد از بارگذاری صفحه به‌طور موقت در دسترس خواهند بود و سپس به‌طور خودکار از بین می‌روند.

در این مقاله، به نحوه استفاده و مدیریت پیام‌های فلش در لاراول می‌پردازیم.

1. 🛠 چگونه پیام‌های فلش در لاراول کار می‌کنند؟

لاراول از session برای ذخیره‌سازی پیام‌های فلش استفاده می‌کند. این پیام‌ها پس از نمایش، به‌طور خودکار از session حذف می‌شوند.

1.1. ارسال پیام فلش

برای ارسال پیام فلش، شما از متد session()->flash() یا متد with() در ردایرکت‌ها استفاده می‌کنید. پیام‌ها معمولاً شامل یک پیام و نوع آن (مانند "موفقیت" یا "خطا") هستند.

مثال استفاده از session()->flash():

php
CopyEdit
public function store(Request $request)
{
    // ذخیره اطلاعات در دیتابیس یا عملیات دیگر
    
    session()->flash('success', 'اطلاعات با موفقیت ذخیره شد.');
    return redirect()->route('home');
}

مثال استفاده از with() در ردایرکت:

php
CopyEdit
public function store(Request $request)
{
    // ذخیره اطلاعات در دیتابیس یا عملیات دیگر
    
    return redirect()->route('home')->with('success', 'اطلاعات با موفقیت ذخیره شد.');
}

در اینجا، پیام success با متن "اطلاعات با موفقیت ذخیره شد" به session افزوده می‌شود و بعد از بارگذاری صفحه جدید در دسترس قرار می‌گیرد.

2. 📤 نمایش پیام‌های فلش در ویو

برای نمایش پیام‌های فلش در ویو، می‌توانید از متد session() یا تابع old() استفاده کنید. لاراول به‌طور پیش‌فرض پیام‌ها را در یک فایل ویو قرار می‌دهد که می‌توانید آن را برای نمایش پیام‌ها استفاده کنید.

2.1. نمایش پیام‌های فلش در ویو با Blade

در ویوهای Blade، می‌توانید پیام‌های فلش را به‌صورت زیر نمایش دهید:

php
CopyEdit
@if(session('success'))
    <div class="alert alert-success">
        {{ session('success') }}
    </div>
@endif

@if(session('error'))
    <div class="alert alert-danger">
        {{ session('error') }}
    </div>
@endif

در این مثال، پیام‌هایی که با کلید success یا error در session ذخیره شده‌اند، در ویو نمایش داده می‌شوند. شما می‌توانید استایل‌های خود را برای انواع مختلف پیام‌ها (مثل پیام موفقیت یا خطا) اضافه کنید.

2.2. استفاده از پیام‌های فلش در قالب

اگر بخواهید پیام‌ها را با یک استایل خاص (مثلاً در قالب Bootstrap) نمایش دهید، می‌توانید از کلاس‌های مناسب استفاده کنید:

php
CopyEdit
@if(session('success'))
    <div class="alert alert-success" role="alert">
        {{ session('success') }}
    </div>
@endif

@if(session('error'))
    <div class="alert alert-danger" role="alert">
        {{ session('error') }}
    </div>
@endif

در این مثال، پیام‌های موفقیت در یک div با کلاس alert-success و پیام‌های خطا در یک div با کلاس alert-danger نمایش داده می‌شوند.

3. 💡 پیام‌های فلش در چندین درخواست

اگر بخواهید پیام فلش را برای درخواست‌های متعدد نگهداری کنید، لاراول به شما این امکان را می‌دهد که از متد session()->reflash() استفاده کنید. این متد پیام فلش را برای یک درخواست دیگر نیز حفظ می‌کند.

مثال:

php
CopyEdit
public function store(Request $request)
{
    session()->flash('success', 'اطلاعات با موفقیت ذخیره شد.');
    session()->reflash(); // پیام فلش برای درخواست بعدی نگهداری می‌شود
    return redirect()->route('home');
}

4. 🔄 حذف پیام‌های فلش

لاراول به‌طور خودکار پیام‌های فلش را پس از نمایش آن‌ها حذف می‌کند، اما اگر بخواهید پیام‌ها را دستی حذف کنید، می‌توانید از متد session()->forget() استفاده کنید.

مثال:

php
CopyEdit
public function store(Request $request)
{
    session()->flash('success', 'اطلاعات با موفقیت ذخیره شد.');
    
    // حذف پیام فلش پس از نمایش
    session()->forget('success');
    
    return redirect()->route('home');
}

5. 🔒 استفاده از پیام‌های فلش برای تأیید عملیات‌ها

پیام‌های فلش معمولاً برای اطلاع‌رسانی به کاربر در مورد موفقیت یا شکست عملیات‌ها استفاده می‌شوند. برای مثال، پس از ارسال فرم یا تایید عملیات، پیام‌هایی مانند "عملیات با موفقیت انجام شد" یا "عملیات ناموفق بود" نمایش داده می‌شود.

مثال:

php
CopyEdit
public function update(Request $request, $id)
{
    $product = Product::find($id);
    $product->update($request->all());
    
    session()->flash('success', 'محصول با موفقیت به‌روزرسانی شد.');
    
    return redirect()->route('products.index');
}

6. 🧑‍💻 مدیریت پیام‌های فلش با چندین نوع پیام

شما می‌توانید چندین نوع پیام فلش مختلف (مانند پیام موفقیت، هشدار، خطا و غیره) را همزمان استفاده کنید. برای این کار، از چندین کلید برای ذخیره‌سازی پیام‌ها در session استفاده کنید:

php
CopyEdit
public function store(Request $request)
{
    session()->flash('success', 'اطلاعات با موفقیت ذخیره شد.');
    session()->flash('warning', 'اطلاعات ممکن است صحیح نباشد.');
    session()->flash('error', 'یک خطا رخ داده است.');
    
    return redirect()->route('home');
}

سپس، در ویو می‌توانید پیام‌های مختلف را بر اساس نوع آن‌ها نمایش دهید:

php
CopyEdit
@if(session('success'))
    <div class="alert alert-success">{{ session('success') }}</div>
@endif

@if(session('warning'))
    <div class="alert alert-warning">{{ session('warning') }}</div>
@endif

@if(session('error'))
    <div class="alert alert-danger">{{ session('error') }}</div>
@endif

نتیجه‌گیری

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