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

دليل الاستضافة المشتركة (cPanel, Plesk, DirectAdmin)

تم بناء LeadHub من الأساس للعمل على الاستضافة المشتركة. لا تحتاج إلى VPS أو خادم مخصص أو وصول SSH أو أي معرفة بسطر الأوامر. إذا كنت تستطيع رفع ملف وملء نموذج ويب، يمكنك تثبيت وتشغيل LeadHub.

يغطي هذا الدليل كل ما يخص بيئات الاستضافة المشتركة.

ما لا تحتاجه على الإطلاق​

  • لا SSH / طرفية / سطر أوامر
  • لا أوامر artisan
  • لا Composer — جميع الاعتماديات في مجلد vendor/
  • لا Node.js أو npm
  • لا Redis — يستخدم التخزين المؤقت المبني على الملفات
  • لا Supervisor — cron.php يتولى كل شيء
  • لا وصول root

ما تحتاجه​

  • PHP 8.3 أو أعلى
  • قاعدة بيانات MySQL
  • القدرة على إضافة مهمة cron
  • حوالي 500 ميجابايت مساحة حرة
  • Apache مع mod_rewrite

الخيار أ — نطاق إضافي (موصى به)​

الخطوة 1: إنشاء نطاق إضافي​

في cPanel:

  1. انقر على Addon Domains.
  2. Document Root: غيّره إلى public_html/leadhub/public
  3. انقر على Add Domain.

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

public_html/
  leadhub/
    app/
    public/          ← نطاقك يشير إلى هنا
    storage/
    vendor/
    cron.php

الخطوة 3-5: قاعدة البيانات، الصلاحيات، التثبيت​

أنشئ قاعدة بيانات MySQL، عيّن storage و bootstrap/cache إلى 755، ثم زر /install.

الخيار ب — تثبيت مباشر في public_html/​

انقل كل شيء من leadhub/public/ إلى public_html/ مباشرة. يكتشف index.php هذا التخطيط تلقائياً.

إعداد مهمة Cron — حرج​

هذه هي الخطوة الأكثر أهمية بعد التثبيت.

في cPanel​

php /home/yourusername/public_html/leadhub/cron.php >> /dev/null 2>&1

جميع حقول الوقت * (كل دقيقة).

في Plesk​

php /var/www/vhosts/yourdomain.com/leadhub/cron.php >> /dev/null 2>&1

في DirectAdmin​

php /home/yourusername/domains/yourdomain.com/leadhub/cron.php >> /dev/null 2>&1

مسارات PHP الشائعة​

/usr/local/bin/php، /usr/bin/php، /opt/cpanel/ea-php83/root/usr/bin/php

بديل: Cron عبر الويب​

أضف CRON_SECRET=سرك_العشوائي إلى .env:

https://yourdomain.com/cron.php?token=سرك_العشوائي

مرجع الصلاحيات​

المجلدالصلاحيةالسبب
storage/755الجلسات، السجلات، التخزين المؤقت
bootstrap/cache/755التكوين المجمّع
public/755ملفات الويب
ملفات PHP644قابلة للقراءة
.env640 أو 644حساس

اختيار إصدار PHP​

cPanel: Software → MultiPHP Manager → PHP 8.3 → Apply. Plesk: Websites & Domains → PHP Settings → PHP 8.3 → OK. DirectAdmin: Domain Setup → PHP Version → 8.3.

استكشاف الأخطاء​

المشكلةالسببالحل
صفحة بيضاءإصدار PHP خاطئغيّر إلى PHP 8.3
خطأ 404ملفات في مكان خاطئتحقق من المواقع و .htaccess
خطأ 403صلاحيات خاطئةعيّن إلى 755
Cron لا يعملمسار خاطئتحقق من المسار الكامل
الأتمتة لا تعملCron غير مُعدتحقق من مهمة cron
البريد لا يُرسلغير مُعدالإعدادات → البريد الإلكتروني
فشل اتصال قاعدة البياناتبيانات خاطئةتحقق من بيانات الاعتماد
المثبّت يقول مثبّتinstalled.lock موجوداحذفه من storage/