
# تسجيل الأخطاء

في طلب البيئة المعزولة المحددة، يعرّف التمهيد `WP_DEBUG` بأنه `true`، و`WP_DEBUG_LOG` بأنه `debug.log` الخاص بالبيئة المعزولة، و`WP_DEBUG_DISPLAY` بأنه `false`، لتُسجّل الأخطاء في ملف خاص بالبيئة المعزولة بدلًا من المتصفح.

لا يُعرّف كل عنصر من هذه العناصر إلا إذا لم يكن `wp-config.php` قد عرّفه مسبقًا، ويوضع سطر التمهيد مباشرة فوق سطر `wp-settings.php`، بعد بقية `wp-config.php`. ويعرّف `wp-config.php` القياسي `WP_DEBUG` بأنه `false`، لذا لا تسجل طلبات البيئة المعزولة على مثل هذا التثبيت إلى `debug.log` ([المشكلة رقم 4](https://github.com/inline0/rudel/issues/4)). للحصول على سجلات خاصة بكل بيئة معزولة هناك، أزل تعريفات `WP_DEBUG` و`WP_DEBUG_LOG` و`WP_DEBUG_DISPLAY` من `wp-config.php`. عندها يُبقي WordPress تصحيح الأخطاء معطلًا لطلبات المضيف، ويُفعّل التمهيد التسجيل لطلبات البيئة المعزولة.

## عرض السجلات

```bash
wp rudel logs alpha-3be7
wp rudel logs alpha-3be7 --lines=200
wp rudel logs alpha-3be7 --follow
```

القيمة الافتراضية هي آخر 50 سطرًا. يشغّل `--follow` الأمر `tail -f` على الملف.

## مسح السجلات

```bash
wp rudel logs alpha-3be7 --clear
```

## موقع السجل

يوجد ملف السجل في دليل البيئة المعزولة:

```text
wp-content/rudel-environments/{id}/debug.log
```

يقع هذا الدليل داخل `wp-content`، وتخدمه خوادم الويب مثل أي ملف آخر فيه. امنع الوصول عبر الويب إلى ملفات `*.log` وإلى أدلة `snapshots` الموجودة تحت `rudel-environments` على أي مضيف يمكن للآخرين الوصول إليه ([المشكلة رقم 9](https://github.com/inline0/rudel/issues/9)).

## البريد الإلكتروني المحظور

تحظر طلبات البيئة المعزولة إرسال البريد الصادر. عند تعريف `WP_DEBUG_LOG`، يُسجّل كل بريد محظور مع المستلم والموضوع عبر `error_log()`. ولا يصل إلى `debug.log` الخاص بالبيئة المعزولة إلا عندما يكون تسجيل تصحيح الأخطاء نشطًا كما هو موضح أعلاه؛ وإلا فيذهب إلى سجل الأخطاء الافتراضي لـ PHP.
