سجلات الأخطاء تُدوّن المشكلات التي تحدث على موقعك، بما في ذلك أخطاء PHP، وفشل الاتصال بقاعدة البيانات، ومشكلات الإضافات. عندما يحدث خطأ ما على موقعك، يكون سجل الأخطاء غالبًا أسرع وسيلة لتحديد السبب.
الوصول إلى السجلات عبر مدير الملفات أو SFTP
لا يحتوي KPanel على تبويب مخصص للسجلات. يتم تخزين ملفات السجل على الخادم ويمكن الوصول إليها عبر مدير الملفات أو SFTP.
باستخدام مدير الملفات:
- سجّل الدخول إلى KPanel على kpanel.kapsulehost.com
- اذهب إلى المواقع الإلكترونية واختر الموقع المتأثر
- انقر على الإعدادات ← مدير الملفات
- انتقل إلى الدليل
logs/الموجود في جذر موقعك
باستخدام SFTP:
- اذهب إلى الإعدادات ← SFTP في KPanel للحصول على تفاصيل اتصال موقعك
- اتصل باستخدام FileZilla أو عميل SFTP المفضل لديك
- انتقل إلى الدليل
logs/الموجود في جذر موقعك
يحتوي الدليل logs/ على:
- سجل أخطاء PHP، الأخطاء الناتجة عن كود PHP (أكثر السجلات طلبًا)
- سجل الوصول، سجل بجميع طلبات HTTP الموجهة إلى موقعك
- سجل الأخطاء، أخطاء على مستوى الخادم (500، 502، إلخ)
قراءة سجل أخطاء PHP
يبدو إدخال نموذجي في سجل أخطاء PHP كما يلي:
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
يُظهر هذا لك التاريخ والوقت، ونوع الخطأ، ووصفًا للمشكلة، ومسار الملف ورقم السطر الذي حدث فيه الخطأ.
أنواع الأخطاء الشائعة
| النوع | درجة الخطورة | ماذا يعني |
|---|---|---|
| خطأ فادح (Fatal error) | مرتفعة | توقّف التنفيذ. لن تُحمَّل الصفحة. |
| تحذير (Warning) | متوسطة | حدث أمر غير متوقع لكن التنفيذ استمر. |
| ملاحظة (Notice) | منخفضة | مشكلة بسيطة، غالبًا مخالفة لأفضل ممارسات البرمجة. |
| قديم (Deprecated) | منخفضة | وظيفة مستخدمة سيتم إزالتها في إصدار مستقبلي من PHP. |
تفعيل وضع التصحيح في WordPress
بالنسبة لمواقع WordPress، يؤدي تفعيل وضع التصحيح إلى إظهار معلومات أكثر تفصيلًا عن الأخطاء:
- اتصل عبر SFTP أو استخدم مدير الملفات في KPanel
- افتح الملف
wp-config.phpفي جذر WordPress - أضف أو حدّث هذه الأسطر:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
سيتم كتابة الأخطاء في wp-content/debug.log بدلًا من عرضها على الشاشة.
لا تترك WP_DEBUG_DISPLAY مضبوطًا على true في موقع مباشر (نشط)، لأن هذا قد يُعرّض معلومات حساسة للزوار.
تحقق من سجلات الأخطاء فورًا بعد تحديث WordPress أو الإضافات أو القوالب. العديد من المشكلات التي تظهر بعد التحديث تترك آثارًا واضحة في سجل أخطاء PHP.