ساخت میکروفرانت‌اند با Multi-Zones در Next.js – تفکیک مسیرها، کاهش حجم، و توسعه مستقل

Multi-Zones در Next.js روشی برای ساخت میکروفرانت‌اند است که اپلیکیشن بزرگ را به چند اپلیکیشن مستقل تقسیم می‌کند. این مقاله نحوهٔ تعریف zone، تنظیم assetPrefix، روتینگ درخواست‌ها، استفاده از proxy، اشتراک‌گذاری کد، و پشتیبانی از Server Actions را بررسی می‌کند.

Multi-ZonesMicro-FrontendassetPrefixServer Actions

~3 دقیقه مطالعه · آخرین به‌روزرسانی ۶ آبان ۱۴۰۴

مقدمه


Multi-Zones در Next.js روشی برای ساخت میکروفرانت‌اند است که به شما اجازه می‌دهد اپلیکیشن بزرگ را به چند اپلیکیشن مستقل تقسیم کنید. هر zone مجموعه‌ای از مسیرها را مدیریت می‌کند و می‌تواند به‌صورت جداگانه توسعه و deploy شود.


مثال کاربردی


فرض کنید مسیرهای زیر را دارید:

  • /blog/* برای پست‌های بلاگ
  • /dashboard/* برای صفحات داشبورد کاربران
  • /* برای سایر صفحات عمومی

با Multi-Zones می‌توانید سه اپلیکیشن مستقل بسازید که همگی روی یک دامنه اجرا شوند اما به‌صورت جداگانه مدیریت شوند.


تعریف یک Zone


هر zone یک اپلیکیشن Next.js معمولی است که با assetPrefix پیکربندی می‌شود:

const nextConfig = {
  assetPrefix: '/blog-static',
}

این تنظیم باعث می‌شود فایل‌های JS و CSS با prefix مشخصی بارگذاری شوند تا با سایر zoneها تداخل نداشته باشند.


تنظیم rewrite برای نسخه‌های قدیمی‌تر


در نسخه‌های قبل از Next.js 15، ممکن است نیاز به تنظیم rewrites برای مدیریت فایل‌های استاتیک داشته باشید:

async rewrites() {
  return {
    beforeFiles: [
      {
        source: '/blog-static/_next/:path+',
        destination: '/_next/:path+',
      },
    ],
  }
}

مسیریابی درخواست‌ها به zone مناسب


برای ارسال مسیرها به zone مناسب، می‌توانید از rewrites استفاده کنید:

async rewrites() {
  return [
    {
      source: '/blog',
      destination: `${process.env.BLOG_DOMAIN}/blog`,
    },
    {
      source: '/blog/:path+',
      destination: `${process.env.BLOG_DOMAIN}/blog/:path+`,
    },
    {
      source: '/blog-static/:path+',
      destination: `${process.env.BLOG_DOMAIN}/blog-static/:path+`,
    },
  ]
}

توجه: مسیرهای URL باید در هر zone منحصربه‌فرد باشند تا از تداخل جلوگیری شود.


استفاده از proxy برای روتینگ پویا


در شرایطی که نیاز به تصمیم‌گیری پویا دارید (مثلاً با feature flag)، می‌توانید از proxy استفاده کنید:

export async function proxy(request) {
  const { pathname, search } = req.nextUrl;
  if (pathname === '/your-path' && myFeatureFlag.isEnabled()) {
    return NextResponse.rewrite(`${rewriteDomain}${pathname}${search}`);
  }
}

لینک‌دهی بین zoneها


برای لینک‌دهی بین zoneها از تگ <a> استفاده کنید، نه <Link>، چون Link تلاش می‌کند مسیر را soft navigate کند که در zone دیگر ممکن نیست.


اشتراک‌گذاری کد بین zoneها


می‌توانید zoneها را در یک monorepo قرار دهید یا از پکیج‌های NPM عمومی/خصوصی برای اشتراک‌گذاری کد استفاده کنید. استفاده از feature flag نیز برای هماهنگی بین zoneها مفید است.


پشتیبانی از Server Actions


برای استفاده از Server Actions در Multi-Zones، باید دامنه اصلی را به‌صورت صریح مجاز کنید:

experimental: {
  serverActions: {
    allowedOrigins: ['your-production-domain.com'],
  },
}

جمع‌بندی


Multi-Zones در Next.js راهکاری قدرتمند برای ساخت میکروفرانت‌اندهای مستقل، قابل توسعه و قابل مدیریت است. با تفکیک مسیرها، بهینه‌سازی منابع، و استفاده از ابزارهای مدرن، می‌توانید اپلیکیشن‌هایی مقیاس‌پذیر و سریع بسازید.


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

ادامه

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

ادامه

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

ادامه

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

ادامه

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

ادامه

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

ادامه