أداة ضبط WP_DEBUG

فعّل سجل التصحيح دون تعطيل موقعك المباشر

يعمل في متصفحك. لا يُرفع أي شيء.

Where is this site?

This changes the recommendation, not just the wording. The safe configuration on a live site is genuinely different from the useful one on your laptop.

Live site Local / staging

Verdict

—

Options

WP_DEBUG — turn debugging onMakes WordPress report PHP notices, warnings and deprecations it would otherwise swallow. WP_DEBUG_LOG — write to a fileErrors go to wp-content/debug.log instead of the screen. This is the constant that makes debugging on a live site safe. WP_DEBUG_DISPLAY false — hide errors from visitorsWithout this, WP_DEBUG prints PHP errors into your pages. Turning it off is the single most important line on this page. Write the log outside the web rootwp-content/debug.log is publicly readable on many hosts — anyone can just fetch it. Moving it above the web root fixes that. Adjust the path to match your server. SAVEQUERIES — log every database queryUseful for hunting a slow page. Costs memory on EVERY request, so turn it off again afterwards. SCRIPT_DEBUG — load unminified core JS/CSSOnly useful if you are debugging the block editor or core scripts.

wp-config.php

Paste these ABOVE the line that says /* That's all, stop editing! */ — anything below it is ignored, which is why so many people report that WP_DEBUG 'does nothing'.

عن أداة ضبط WP_DEBUG

أنشئ ثوابت WP_DEBUG التي تكتب الأخطاء في ملف سجل بدلًا من عرضها لزوّارك. مقتطف WP_DEBUG الافتراضي الذي تنسخه معظم المواقع سيعرض أخطاء PHP للعلن — أما هذا فلن يفعل.

ذات صلة

أدوات أخرى قد تحتاجها

أداة فك أخطاء PHP الفادحة في ووردبريس

الصق الخطأ. ونحن نحدّد الإضافة.

مولّد wp-config.php

أنشئ ملف wp-config.php صحيحًا دون نسخ ولصق من تدوينة قديمة من عام 2014

FAQ

أسئلة

هل من الآمن تفعيل WP_DEBUG على موقع مباشر؟

فقط مع ضبط WP_DEBUG_DISPLAY على false. WP_DEBUG وحده يطبع إشعارات وتحذيرات PHP — بما فيها مسارات الملفات المطلقة لخادمك — مباشرة داخل الصفحات التي يحمّلها زوّارك. يعطيك كل درس تقريبًا ذلك السطر الواحد ويتوقف. اقرنه بـ WP_DEBUG_LOG و WP_DEBUG_DISPLAY بقيمة false ويصبح آمنًا.

أين يذهب سجل تتبّع أخطاء WordPress؟

إلى wp-content/debug.log افتراضيًا. جدير بالمعرفة: على كثير من الاستضافات يكون ذلك الملف قابلًا للجلب علنًا — يمكن لأي أحد طلبه في المتصفح. يمكنك تمرير مسار إلى WP_DEBUG_LOG بدلًا من ذلك وكتابة السجل فوق الجذر الرئيسي، وهو ما ستولّده لك هذه الأداة.

ضبطت WP_DEBUG على true ولم يحدث شيء. لماذا؟

شبه دائمًا لأن الثابت أُضيف أسفل السطر الذي يقول "That's all, stop editing!" في wp-config.php. كل شيء بعد ذلك السطر يُتجاهل. انقله إلى الأعلى.