إنتقل إلى المحتوى الرئيسي

دليل الاستضافة المشتركة

يرشدك هذا الدليل خلال تثبيت LeadHub على حساب استضافة مشتركة cPanel نموذجي. لا حاجة لـ SSH أو الطرفية أو صلاحيات الجذر.

ما ستستخدمه​

  • مدير ملفات cPanel (أو FTP)
  • قواعد بيانات MySQL في cPanel
  • مهام Cron في cPanel
  • متصفح ويب

الخطوة 1 — إنشاء قاعدة البيانات​

  1. في cPanel، انقر على MySQL Databases.
  2. أنشئ قاعدة بيانات جديدة، مثل username_leadhub.
  3. أنشئ مستخدم قاعدة بيانات جديداً، مثل username_lhuser، بكلمة مرور قوية.
  4. أضف المستخدم إلى قاعدة البيانات وامنحه All Privileges.
  5. دوّن: اسم قاعدة البيانات، اسم المستخدم، كلمة المرور، والخادم (عادةً localhost).

الخطوة 2 — رفع الملفات​

الخيار أ — مدير الملفات:

  1. انتقل إلى cPanel ← File Manager.
  2. توجّه إلى public_html/ (أو مجلد فرعي إذا أردت تثبيت LeadHub في مجلد).
  3. انقر Upload وارفع ملف LeadHub ZIP.
  4. بعد الرفع، انقر بزر الفأرة الأيمن على ZIP ← Extract إلى public_html/.

الخيار ب — FTP:

  1. استخدم FileZilla أو أي عميل FTP.
  2. اتصل باستضافتك ببيانات اعتماد FTP.
  3. ارفع جميع الملفات من مجلد LeadHub المستخرج مباشرةً إلى public_html/.

⚠️ تأكد من أن index.php موجود مباشرةً في public_html/ — وليس داخل مجلد فرعي.

الخطوة 3 — ضبط الصلاحيات​

في مدير ملفات cPanel:

  1. اختر مجلد storage/ ← انقر بزر الفأرة الأيمن ← Change Permissions ← عيّن 755، وضع علامة على Recurse into subdirectories.
  2. كرر نفس الخطوة لـ bootstrap/cache/.

الخطوة 4 — تشغيل برنامج التثبيت​

افتح متصفحك وانتقل إلى:

https://yourdomain.com/install

أكمل المعالج باتباع دليل التثبيت.

الخطوة 5 — إعداد مهمة Cron​

  1. في cPanel، انقر على Cron Jobs.
  2. تحت Add New Cron Job، عيّن Common Settings إلى "كل دقيقة (* * * * *)".
  3. في حقل Command، أدخل: 
    /usr/bin/php /home/yourusername/public_html/cron.php >> /dev/null 2>&1

    استبدل yourusername باسم مستخدم cPanel الفعلي وعدّل المسار إذا كان LeadHub في مجلد فرعي.

  4. انقر Add New Cron Job.

الخطوة 6 — التحقق من تشغيل Cron​

بعد دقيقتين إلى ثلاث دقائق، في لوحة المشرف الأعلى لـ LeadHub انتقل إلى System Health. يجب أن تظهر حالة الطابور باللون الأخضر. إذا ظهرت "queue not running"، أعد فحص مسار cron.

التثبيت في مجلد فرعي​

إذا أردت تثبيت LeadHub على yourdomain.com/leadhub/ بدلاً من الجذر:

  1. ارفع الملفات إلى public_html/leadhub/.
  2. أثناء التثبيت، عيّن App URL إلى https://yourdomain.com/leadhub.
  3. يصبح مسار cron: /home/yourusername/public_html/leadhub/cron.php.

التثبيت على نطاق فرعي​

لتثبيت LeadHub على app.yourdomain.com:

  1. في cPanel ← Domains (أو Subdomains)، أنشئ app.yourdomain.com يشير إلى مثلاً public_html/leadhub/.
  2. ارفع الملفات إلى public_html/leadhub/.
  3. عيّن App URL إلى https://app.yourdomain.com.

فحص إصدار PHP​

إذا كان cPanel لديك يحتوي على MultiPHP Manager:

  1. انتقل إلى MultiPHP Manager.
  2. ابحث عن نطاقك/نطاقك الفرعي.
  3. اختر PHP 8.4 (أو أعلى إصدار 8.x متاح).
  4. احفظ.

مشاكل cPanel الشائعة​

المشكلةالحل
.htaccess لا يعملفعّل mod_rewrite عبر cPanel ← Apache Handlers، أو تواصل مع المضيف
خطأ 500 Internal Server Errorتحقق من storage/logs/laravel.log في مدير الملفات
امتداد PHP مفقودcPanel ← Select PHP Version ← فعّل الامتداد المفقود
الطابور لا يعملتحقق من مسار cron — استخدم المسار الدقيق من System Health
رفض صلاحيات الملفاتعيّن storage/ و bootstrap/cache/ إلى 755 بشكل تكراري