الدليل العملي لإنشاء وإدارة Subdomains في Laravel

مقدمة: لماذا تحتاج التطبيقات الحديثة إلى Subdomains؟

غالباً لا تقتصر تطبيقات الويب الحديثة على وظيفة واحدة فقط، بل تضم أقساماً متعددة مثل المدونة، المتجر، لوحة التحكم، أو صفحات مخصصة لفئات مختلفة من المستخدمين. ومع ازدياد هذه الأجزاء داخل التطبيق، تصبح مسارات Routes أكثر تعقيداً وأقل وضوحاً إذا تم جمعها كلها تحت نفس البنية التقليدية.

هنا تظهر أهمية Subdomains كحل عملي يساعد على تقسيم التطبيق إلى أجزاء مستقلة ومنظمة، مع الحفاظ على ارتباطها جميعاً بنفس النطاق الرئيسي. وبهذا يحصل المستخدم على تجربة أوضح، كما يستفيد المطور من بنية أكثر مرونة في الإدارة والتوسع.

ما هو Subdomain؟

Subdomain هو جزء إضافي يُضاف قبل اسم النطاق الرئيسي بهدف تخصيص قسم معين من الموقع أو التطبيق. ويُستخدم عادةً لفصل الخدمات أو المحتوى أو الواجهات المختلفة بطريقة مرتبة وسهلة التذكر.

على سبيل المثال، إذا كان لديك موقع رئيسي بعنوان mysite.com، فيمكنك تخصيص:

• blog.mysite.com لقسم المدونة
• store.mysite.com لقسم المتجر
• app.mysite.com للتطبيق أو لوحة المستخدم

بهذه الطريقة، يصبح كل قسم مستقلاً من حيث الوصول والتنظيم، مع بقائه ضمن نفس الهوية العامة للموقع.

لماذا يُعد استخدام Subdomains خياراً ذكياً في Laravel؟

استخدام Subdomains لا يقتصر على الناحية الشكلية فقط، بل يقدم فوائد تقنية واضحة، خاصة في التطبيقات الكبيرة والمتنامية.

1. تحسين تنظيم المشروع

عند فصل أجزاء التطبيق عبر Subdomains، يصبح لكل قسم منطق واضح ومسارات مستقلة، مما يسهل الصيانة والتطوير لاحقاً.

2. تبسيط تجربة المستخدم

المستخدم يستطيع الوصول إلى القسم الذي يريده مباشرة عبر عنوان واضح وسهل الحفظ، مثل blog.domain.com أو store.domain.com.

3. دعم التخصيص لكل مستخدم

بعض التطبيقات تعتمد على تخصيص مساحة مستقلة لكل مستخدم، مثل username.domain.com. هذا النمط شائع في منصات التدوين والخدمات متعددة العملاء.

4. تسهيل الاختبار والتجريب

يمكن استخدام Subdomains لإنشاء بيئات مخصصة مثل beta.domain.com لاختبار التحديثات قبل إطلاقها على البيئة الإنتاجية.

5. قابلية أعلى للتوسع

كلما توسع التطبيق، يصبح من الأسهل فصل الخدمات أو الوحدات المنطقية ضمن Subdomains بدلاً من الإبقاء على كل شيء داخل مسارات متداخلة في نفس النطاق.

إنشاء مشروع Laravel جديد

إذا كنت تستخدم Docker، فيمكنك الاستفادة من Laravel Sail لإنشاء مشروع جديد بسرعة. إليك الأمر المستخدم:

curl -s "https://laravel.build/example-app" | bash

وبالطبع، يمكنك اختيار أي طريقة أخرى تناسب بيئة عملك.

تشغيل خادم Laravel

بعد إنشاء المشروع، شغّل الحاويات عبر الأمر التالي:

./vendor/bin/sail up -d

كيفية إعداد Routes خاصة بـ Subdomains في Laravel

يوفر Laravel دعماً مباشراً لربط المسارات بنطاق معين أو Subdomain محدد. يمكنك تعريف Route خاص بـ Subdomain على هذا النحو:

Route::get('/', function () {
    return 'First sub domain';
})->domain('blog.' . env('APP_URL'));

عندها سيستجيب هذا المسار فقط عندما يتم الوصول إلى blog.domain.com أو ما يعادله حسب قيمة APP_URL.

استخدام Route Groups لتنظيم المسارات

في التطبيقات الواقعية، لن تكتفي بمسار واحد فقط. لذلك من الأفضل جمع كل المسارات التابعة لنفس Subdomain داخل Route Group لتسهيل الإدارة.

Route::domain('blog.' . env('APP_URL'))->group(function () {
    Route::get('posts', function () {
        return 'Second subdomain landing page';
    });

    Route::get('post/{id}', function ($id) {
        return 'Post ' . $id . ' in second subdomain';
    });
});

هذا الأسلوب يجعل جميع المسارات الخاصة بقسم blog موجودة في مكان واحد، وهو ما يقلل الفوضى داخل ملف web.php.

إنشاء Subdomains ديناميكية في Laravel

من أقوى مزايا Laravel في هذا السياق دعمه لـ Dynamic Subdomains. وهذا مفيد جداً عندما ترغب في تخصيص Subdomain لكل مستخدم أو عميل.

يمكنك تمرير جزء من اسم Subdomain كمتغير تماماً كما تفعل مع متغيرات المسار داخل URI.

Route::domain('{username}.' . env('APP_URL'))->group(function () {
    Route::get('post/{id}', function ($username, $id) {
        return 'User ' . $username . ' is trying to read post ' . $id;
    });
});

في المثال السابق، إذا كان لديك عنوان مثل zubair.domain.com، فسيتم تمرير zubair إلى المتغير $username تلقائياً.

متى تكون Dynamic Subdomains مفيدة؟

• منصات التدوين التي تمنح كل كاتب مساحة مستقلة
• أنظمة SaaS متعددة العملاء
• لوحات مخصصة للشركات أو الفرق
• منصات تستند إلى هوية مستخدم أو مؤسسة داخل النطاق

تنظيم Routes عبر RouteServiceProvider

عندما يكبر المشروع، قد يصبح ملف web.php مزدحماً بشكل يصعب معه تتبع المسارات. في هذه الحالة، من الأفضل توزيع المسارات على ملفات منفصلة، بحيث يمتلك كل Subdomain ملف Routes خاصاً به.

داخل ملف RouteServiceProvider.php ستجد الإعداد الافتراضي التالي داخل الدالة boot:

public function boot()
{
    $this->configureRateLimiting();

    $this->routes(function () {
        Route::prefix('api')
            ->middleware('api')
            ->namespace($this->namespace)
            ->group(base_path('routes/api.php'));

        Route::middleware('web')
            ->namespace($this->namespace)
            ->group(base_path('routes/web.php'));
    });
}

هذا الإعداد يفصل افتراضياً بين مسارات api.php وweb.php. ويمكنك اعتماد الفكرة نفسها لإضافة ملف Routes خاص بـ Subdomain معين.

إضافة ملف Routes مخصص لـ blog Subdomain

أضف المقطع التالي داخل إعداد المسارات:

Route::domain('blog.' . env('APP_URL'))
    ->middleware('web')
    ->namespace($this->namespace)
    ->group(base_path('routes/blog.php'));

بهذا الشكل، سيقوم Laravel بتحميل المسارات من الملف routes/blog.php عند زيارة blog.domain.com.

إنشاء ملف blog.php

الآن أنشئ ملفاً جديداً داخل مجلد routes باسم blog.php، ثم أضف إليه المثال التالي:

<?php

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return 'Route using separate file';
});

هذه الطريقة تمنحك تنظيماً ممتازاً، خصوصاً عندما يتضمن كل Subdomain عدداً كبيراً من الصفحات أو Controllers مستقلة.

إعداد الخادم أو البيئة المحلية لدعم Subdomains

بعد الانتهاء من إعداد الكود، يتبقى جزء مهم وهو تهيئة البيئة المحلية حتى تتعرف على Subdomains بشكل صحيح.

إذا كنت تستخدم Laravel Valet

يمكنك ربط النطاقات بسهولة عبر الأوامر التالية من داخل مجلد المشروع:

valet link domain
valet link blog.domain

إذا كنت لا تستخدم Laravel Valet

يمكنك تعديل ملف /etc/hosts/ وإضافة الأسطر التالية:

127.0.0.1 domain.test
127.0.0.1 blog.domain.test

الفكرة هنا بسيطة: أنت تربط النطاق المحلي بعنوان 127.0.0.1 حتى يتم توجيه الطلبات إلى جهازك أثناء التطوير.

أفضل الممارسات عند استخدام Subdomains في Laravel

• استخدم Subdomains فقط عندما يكون هناك فصل منطقي حقيقي بين أقسام التطبيق.
• حافظ على تسمية واضحة وثابتة للنطاقات الفرعية لتسهيل الإدارة.
• قسّم ملفات Routes عند نمو المشروع لتجنب التضخم داخل web.php.
• اختبر إعدادات APP_URL بعناية، لأن أي خطأ فيها قد يؤدي إلى فشل مطابقة النطاق.
• انتبه إلى إعدادات الجلسات وملفات تعريف الارتباط cookies إذا كنت تتعامل مع تسجيل دخول عبر أكثر من Subdomain.

متى يكون استخدام Subdomains أفضل من المسارات التقليدية؟

ليس كل مشروع بحاجة إلى Subdomains. في بعض الحالات، يكون استخدام المسارات العادية مثل domain.com/blog كافياً. لكن إذا كان لديك:

• وحدات مستقلة داخل التطبيق
• مستخدمون أو عملاء متعددون
• حاجة إلى تخصيص بيئات أو إصدارات منفصلة
• فصل واضح بين الواجهة العامة والخدمات الداخلية

فإن Subdomains تصبح خياراً عملياً وأكثر احترافية من الاعتماد الكامل على المسارات التقليدية.

الخلاصة التقنية

يوفر Laravel آليات مرنة جداً للتعامل مع Subdomains، سواء كانت ثابتة أو ديناميكية، وسواء تم تعريفها مباشرة داخل web.php أو عبر ملفات Routes منفصلة من خلال RouteServiceProvider. من الناحية التقنية، يُعد هذا الأسلوب مناسباً جداً للتطبيقات القابلة للتوسع، خاصة عند بناء منصات متعددة الأقسام أو متعددة العملاء. وإذا تم تطبيقه بشكل مدروس، فسيمنحك تنظيماً أفضل للكود وتجربة استخدام أكثر وضوحاً واستقراراً.