# الوصول إلى سجلات أخطاء موقعك الإلكتروني

Source: https://support.kapsulehost.com/ar-ae/error-logs

سجلات الأخطاء تُدوّن المشكلات التي تحدث على موقعك، بما في ذلك أخطاء PHP، وفشل الاتصال بقاعدة البيانات، ومشكلات الإضافات. عندما يحدث خطأ ما على موقعك، يكون سجل الأخطاء غالبًا أسرع وسيلة لتحديد السبب.

### الوصول إلى السجلات عبر مدير الملفات أو SFTP

لا يحتوي KPanel على تبويب مخصص للسجلات. يتم تخزين ملفات السجل على الخادم ويمكن الوصول إليها عبر مدير الملفات أو SFTP.

**باستخدام [مدير الملفات](https://support.kapsulehost.com/ar-ae/file-manager):**

1. سجّل الدخول إلى KPanel على [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com)
2. اذهب إلى **المواقع الإلكترونية** واختر الموقع المتأثر
3. انقر على **الإعدادات ← مدير الملفات**
4. انتقل إلى الدليل `logs/` الموجود في جذر موقعك

**باستخدام [SFTP](https://support.kapsulehost.com/ar-ae/sftp-access):**

1. اذهب إلى **الإعدادات ← SFTP** في KPanel للحصول على تفاصيل اتصال موقعك
2. اتصل باستخدام FileZilla أو عميل SFTP المفضل لديك
3. انتقل إلى الدليل `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، يؤدي تفعيل وضع التصحيح إلى إظهار معلومات أكثر تفصيلًا عن الأخطاء:

1. اتصل عبر SFTP أو استخدم مدير الملفات في KPanel
2. افتح الملف `wp-config.php` في جذر WordPress
3. أضف أو حدّث هذه الأسطر:

```php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```

سيتم كتابة الأخطاء في `wp-content/debug.log` بدلًا من عرضها على الشاشة.

> **Warning:** لا تترك `WP_DEBUG_DISPLAY` مضبوطًا على `true` في موقع مباشر (نشط)، لأن هذا قد يُعرّض معلومات حساسة للزوار.

> **Tip:** تحقق من سجلات الأخطاء فورًا بعد [تحديث WordPress أو الإضافات أو القوالب](https://support.kapsulehost.com/ar-ae/wordpress-updates). العديد من المشكلات التي تظهر بعد التحديث تترك آثارًا واضحة في سجل أخطاء PHP.