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

استكشاف الأخطاء وإصلاحها

مشاكل التثبيت​

"لا يمكن الاتصال بقاعدة البيانات"​

  1. جرّب 127.0.0.1 بدلاً من localhost
  2. تحقق من بيانات الاعتماد عبر phpMyAdmin
  3. تحقق من صلاحيات مستخدم MySQL
  4. في cPanel، مضيف قاعدة البيانات دائمًا localhost

المُثبّت يعيد التوجيه إلى الصفحة الرئيسية​

config/database.php موجود بالفعل من محاولة سابقة. احذفه وحاول مرة أخرى.

تسجيل الدخول يعرض صفحة فارغة​

تحقق من سجل أخطاء PHP بحثًا عن Fatal error أو Call to undefined function. الأكثر شيوعًا: إضافة pdo_mysql مفقودة.

الرسائل لا تظهر​

رسائل webhook لا تصل​

  1. هل عنوان URL الخاص بـ webhook مُكوّن في لوحة تحكم المزود؟
  2. هل يستخدم العنوان HTTPS؟
  3. هل القناة نشطة (التبديل مُفعّل)؟
  4. تحقق من جدول webhook_events بحثًا عن إدخالات failed

رسائل البريد الإلكتروني لا تظهر​

  1. هل مهمة cron تعمل؟
  2. هل إضافة PHP imap محملة؟
  3. هل بيانات اعتماد IMAP صحيحة؟

تحديثات SSE في الوقت الفعلي لا تعمل​

  1. تحقق من أدوات المطور في المتصفح → الشبكة لطلب /sse
  2. تخزين Nginx المؤقت؟ اضبط X-Accel-Buffering: no
  3. CDN/Cloudflare؟ فعّل وضع البث
  4. max_execution_time في PHP يجب أن يكون 60 ثانية على الأقل

فشل الإرسال​

رد WhatsApp لم يتم تسليمه​

  1. هل Access Token صالح؟ الرموز المؤقتة تنتهي خلال ~24 ساعة
  2. هل رقم الهاتف بتنسيق E.164 بدون +؟
  3. هل تطبيق Meta لا يزال في وضع Development؟

ردود البريد الإلكتروني لا تصل​

mail() في PHP قد لا يكون مُكوّنًا على VPS. قم بتكوين Postfix أو استخدم واجهة برمجة تطبيقات للبريد الإلكتروني.

أخطاء PHP الشائعة​

الخطأالإصلاح
Call to undefined function imap_open()الاستضافة المشتركة: cPanel → اختيار إصدار PHP → تفعيل imap. VPS: sudo apt install php-imap
Permission denied: config/database.phpاضبط config/ على 755 عبر مدير الملفات أو chmod 755 config/
Maximum execution time exceededاضبط max_execution_time = 120 في php.ini

الحصول على مزيد من المساعدة​

  1. سجل أخطاء PHP — cPanel: السجلات → سجل الأخطاء. VPS: /var/log/apache2/error.log
  2. سجل أحداث Webhook — افحص جدول webhook_events في phpMyAdmin
  3. مخرجات Cron — قم بزيارة عنوان URL الخاص بـ cron في المتصفح
  4. وحدة تحكم المتصفح — F12 → Console لأخطاء JavaScript