دليل نشر Laravel – نصائح وحيل

خطوات احترافية لنقل مشروعك من البيئة المحلية إلى السيرفر

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

1. تحضير النسخة النهائية (Build)

قم بتشغيل الأمر npm run build لضغط ملفات الـ Assets إذا كنت تستخدم Vite.
قم بضغط ملفات المشروع (Zip) مع استثناء المجلدات غير الضرورية مثل node_modules.

2. الرفع إلى السيرفر

ارفع ملف الـ Zip عبر FTP أو لوحة التحكم، ثم استخرج الملفات خارج مجلد public_html (مثلاً في مجلد باسم laravel). قم بحذف أو تغيير اسم مجلد public_html القديم كنسخة احتياطية.

3. إعداد المجلد العام (Symbolic Link)

استخدم SSH لإنشاء رابط رمزي من مجلد Laravel العام إلى public_html:

cd [path/to/yourdomain]
ln -s ./laravel/public /public_html

4. رابط التخزين (Storage Link)

للوصول إلى الملفات المرفوعة، يجب إنشاء رابط لمجلد التخزين:

cd laravel/public
rm storage #إذا كان موجوداً مسبقاً
ln -s ../storage/app/public storage

5. حل مشكلة Vite (Hot Reload)

اذهب إلى مجلد public وقم بحذف ملف hot. هذا سيمنع Vite من محاولة الاتصال ببيئة التطوير المحلية وسيعمل بشكل صحيح في الإنتاج.

6. إعداد البيئة وقواعد البيانات

قم بتعديل ملف .env وتحديث بيانات قاعدة البيانات:

DB_DATABASE=your_db_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

7. تنظيف الكاش والتحسين

بعد الإعداد، قم بتنظيف الكاش لضمان تطبيق التغييرات:

Config Cache

php artisan config:cache

Route Cache

php artisan route:cache

View Cache

php artisan view:cache

نصائح وحيل إضافية

تأكد من إعطاء الصلاحيات المناسبة لمجلدات storage و bootstrap/cache.
استخدم الأمر php artisan migrate --force لتشغيل التهجير في بيئة الإنتاج.
تأكد دائماً أن قيمة APP_URL في ملف .env تطابق نطاق موقعك الفعلي.

هل سار كل شيء على ما يرام؟

باتباع هذه الخطوات، سيعمل تطبيق Laravel الخاص بك بسلاسة تامة على الاستضافات المشتركة أو السيرفرات الخاصة VPS.

Hcody

نشر تطبيقات Laravel: ملاحظات وحيل مهمة