دستور @include در Blade یکی از پرکاربردترین امکانات در قالب‌سازی Laravel هست که برای وارد کردن یک ویو (partial) در ویو دیگر استفاده می‌شه.

📌 کاربرد اصلی @include

فرض کن یک بخش مثل هدر (header) یا فوتر (footer) یا نوار کناری (sidebar) رو در چند صفحه استفاده می‌کنی. برای جلوگیری از تکرار کد، اون بخش‌ها رو در یک فایل جداگانه می‌نویسی و با @include وارد سایر فایل‌های Blade می‌کنی.

🛠️ سینتکس کلی:

blade
CopyEdit
@include('view.name')

مسیر view.name، اشاره به مسیر فایل در پوشه resources/views بدون پسوند .blade.php داره.

🎯 مثال ساده:

ساخت فایل‌های partial:

resources/views/partials/header.blade.php

blade
CopyEdit
<header>
    <h1>My Website</h1>
</header>

resources/views/partials/footer.blade.php

blade
CopyEdit
<footer>
    <p>&copy; 2025 My Website</p>
</footer>

استفاده در صفحه اصلی:

resources/views/home.blade.php

blade
CopyEdit
@include('partials.header')

<div class="content">
    <p>Welcome to the homepage!</p>
</div>

@include('partials.footer')

🧠 ارسال داده به @include

اگه بخوای داده هم به ویوی شامل‌شده ارسال کنی:

blade
CopyEdit
@include('partials.user', ['user' => $user])

در فایل partials/user.blade.php:

blade
CopyEdit
<p>Hello, {{ $user->name }}</p>

⚠️ نکات مهم

• فایل مورد نظر حتماً باید وجود داشته باشه؛ در غیر این‌صورت ارور می‌گیری.

• اگر می‌خوای فقط در صورت وجود فایل، اون رو بارگذاری کنی، از @includeIf استفاده کن:

blade
CopyEdit
@includeIf('partials.maybe')

✨ سایر نسخه‌های مرتبط: