1. التسجيل في سوريا كلاود والحصول على حساب استضافة مجاني

• زيارة موقع سوريا كلاود: توجه إلى syria-cloud.com واضغط على زر "إنشاء حساب" أو "تسجيل" لإنشاء حساب استضافة مجاني. أدخل بياناتك الأساسية (البريد الإلكتروني، كلمة المرور، وبعض المعلومات الشخصية) ثم قم بتأكيد حسابك عبر الرابط المرسل إلى بريدك الإلكتروني.
• اختيار خطة الاستضافة المجانية: بعد تسجيل الدخول، اختر الخطة المجانية المتوفرة. ستتيح لك الخطة الحصول على موارد محدودة ونطاق فرعي مجاني؛ يمكنك اختيار أحد الدومينات syria-cloud.net أو syria-cloud.org لتجربة مشروعك.

2. إعداد بيئة العمل عبر لوحة التحكم CWP

• الوصول إلى لوحة التحكم CWP: باستخدام بيانات حسابك، ادخل إلى لوحة التحكم CWP المتوفرة في سوريا كلاود. تُتيح لك هذه اللوحة إدارة الملفات، قواعد البيانات، البريد الإلكتروني، وإعدادات الموقع بسهولة.
• إنشاء قاعدة بيانات: من خلال لوحة CWP (عبر أداة إدارة قواعد البيانات مثل phpMyAdmin)، قم بإنشاء قاعدة بيانات جديدة. سجل بيانات القاعدة (اسم القاعدة، اسم المستخدم، وكلمة المرور) لاستخدامها لاحقاً في إعداد Laravel.

3. تطوير مشروع Laravel على جهازك المحلي

نظرًا لعدم إمكانية الوصول إلى سطر الأوامر على الخادم، يُفضّل تطوير المشروع على جهازك المحلي ثم رفعه إلى الاستضافة.

أ. تثبيت Composer وإنشاء مشروع Laravel

1. تثبيت Composer: تأكد من تثبيت Composer على جهازك.
2. إنشاء مشروع Laravel جديد: افتح نافذة الأوامر (Terminal أو CMD) ونفّذ الأمر التالي:

   composer create-project --prefer-dist laravel/laravel myLaravelApp

   (يمكنك استبدال myLaravelApp باسم المشروع الذي تختاره).
3. الدخول إلى مجلد المشروع: بعد انتهاء عملية الإنشاء، انتقل إلى مجلد المشروع:

   cd myLaravelApp

ب. إعداد ملف البيئة (.env)

• افتح ملف .env في المشروع المحلي، وعدّل إعدادات قاعدة البيانات لتتوافق مع بيانات القاعدة التي أنشأتها في لوحة CWP. مثال:

  APP_NAME=MyLaravelApp
  APP_ENV=local
  APP_KEY=       // سيتم توليده لاحقاً
  APP_DEBUG=true
  APP_URL=http://yoursite.syria-cloud.net
  
  DB_CONNECTION=mysql
  DB_HOST=localhost
  DB_PORT=3306
  DB_DATABASE=اسم_قاعدة_البيانات
  DB_USERNAME=اسم_المستخدم
  DB_PASSWORD=كلمة_المرور
          

• لتوليد مفتاح التطبيق، نفّذ الأمر التالي:

  php artisan key:generate

  سيقوم الأمر بتوليد مفتاح جديد وتحديث ملف .env.

ج. تشغيل الترحيلات واختبار التطبيق محلياً

• تشغيل الترحيلات: إذا كنت قد أعددت الترحيلات (Migrations) لقاعدة البيانات، نفّذ الأمر:

  php artisan migrate

• اختبار التطبيق: شغّل الخادم المحلي باستخدام:

  php artisan serve

  ثم افتح المتصفح على الرابط الافتراضي (http://127.0.0.1:8000) للتأكد من عمل التطبيق بشكل صحيح.

4. تجهيز المشروع للنشر على الاستضافة في سوريا كلاود

أ. إعداد نسخة الإنتاج

• تنزيل الحزم بدون وضع التطوير: نفّذ الأمر التالي داخل مجلد المشروع على جهازك المحلي لإعداد نسخة إنتاج نظيفة:

  composer install --optimize-autoloader --no-dev

• ضبط ملف البيئة للنشر: تأكد من تحديث ملف .env ليناسب إعدادات الاستضافة، خاصةً إعدادات قاعدة البيانات ونطاق الموقع. على سبيل المثال:

  APP_URL=http://yoursite.syria-cloud.net
          

ب. رفع ملفات المشروع إلى الخادم

• استخدام مدير الملفات في CWP أو FTP: يمكنك رفع ملفات مشروع Laravel إلى الاستضافة باستخدام:
  • مدير الملفات في CWP: قم بتسجيل الدخول إلى لوحة CWP، ورفع كافة الملفات والمجلدات من المشروع (بما في ذلك مجلدات Laravel مثل app، vendor، resources، وغيرها) إلى المجلد المخصص لاستضافة موقعك (عادةً public_html أو htdocs).
  • برنامج FTP: استخدم برنامج FTP مثل FileZilla للاتصال بالاستضافة باستخدام بيانات FTP الخاصة بحسابك، ثم قم برفع ملفات المشروع.
• تنظيم الملفات: تأكد من أن محتويات مجلد public/ هي التي تُعرض للزوار. إذا كان المجلد العام في الاستضافة هو public_html، يُفضّل نقل محتويات مجلد public إلى public_html وتعديل ملف index.php بحيث يُشير إلى باقي ملفات Laravel (تعديل المسارات إلى autoload.php و bootstrap/app.php إذا لزم الأمر).

5. إدارة أوامر Artisan دون SSH

نظرًا لعدم توفر وصول SSH، يمكنك إدارة أوامر Laravel باستخدام إحدى الطريقتين التاليتين:

أ. إنشاء ملف PHP لتشغيل أوامر Artisan (طريقة مؤقتة)

1. إنشاء ملف مؤقت: أنشئ ملفًا مثل artisan.php في جذر المشروع (بعد رفعه على الخادم) يحتوي على الكود التالي:

   <?php
   require __DIR__ . '/vendor/autoload.php';
   $app = require_once __DIR__ . '/bootstrap/app.php';
   $kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
   
   // مثال لتشغيل الترحيلات
   $exitCode = $kernel->call('migrate', ['--force' => true]);
   echo $kernel->output();
           

2. تشغيل الملف عبر المتصفح: قم بزيارة الرابط (مثلاً: http://yoursite.syria-cloud.net/artisan.php) لتشغيل الأمر المطلوب.
3. تنبيه: احرص على حذف الملف بعد استخدامه لتفادي مخاطر أمنية.

ب. تنفيذ الترحيلات يدويًا

إذا كانت الترحيلات بسيطة، يمكنك استخراج استعلامات SQL من ملفات الترحيل وتشغيلها يدويًا عبر أداة phpMyAdmin المتوفرة في لوحة CWP.

6. اختبار الموقع على الاستضافة

• زيارة الموقع: بعد رفع المشروع وضبط ملف البيئة، افتح المتصفح واكتب عنوان موقعك (مثلاً: http://yoursite.syria-cloud.net) للتأكد من أن الموقع يعمل بشكل صحيح.
• التحقق من الوظائف: تأكد من عمل جميع المكونات مثل الاتصال بقاعدة البيانات، تحميل الصفحات، والتفاعلات بشكل سليم.

7. نصائح إضافية

• الأمان: تأكد من حذف أي ملفات مؤقتة (مثل ملف artisan.php) بعد استخدامها، وراجع تحديثات Laravel والحزم الخاصة به بانتظام.
• الصيانة: احتفظ بنسخ احتياطية من ملفات المشروع وقاعدة البيانات عبر لوحة التحكم CWP.
• الدعم: في حال واجهت مشاكل أثناء رفع الملفات أو تشغيل التطبيق، استخدم دعم سوريا كلاود أو راجع الوثائق والمجموعات الخاصة بهم على وسائل التواصل الاجتماعي.