دليل كامل لتصحيح أخطاء وورد بريس (تمكين WP_DEBUG + أدوات أخرى)

في عالم مثالي ، لن تواجهك مشكلة واحدة تتطلب تصحيح الأخطاء. ولكن في العالم الحقيقي ، من شبه المؤكد أنك ستواجه مشكلات على موقع وورد بريس الخاص بك والتي تتطلب نظرة خفية.

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

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

ماذا يفعل WP Debug؟

تتم كتابة برنامج وورد بريس الأساسي بلغة PHP ، وكذلك الإضافات والسمات.

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

بمجرد تمكين وضع التصحيح ، سترى رسائل مثل هذه متى كانت هناك مشكلة ( حتى لو لم تسبب مشاكل فورية ):

مثال على WP_DEBUG للخطأ في موقع وورد بريس

مثال على WP_DEBUG للخطأ في موقع وورد بريس

يمكنك بعد ذلك حل المشكلة أو الإبلاغ عنها لمطورك أو مطور السمة / المكون الإضافي.

ما هو سجل تصحيح ووردبريس؟

عندما تقوم بتمكين وضع تصحيح أخطاء وورد بريس بمفرده ، سترى رسائل مثل المثال أعلاه على موقعك في الوقت الحالي – ولكن لن يتم حفظ هذه الرسائل في أي مكان.

إذا كنت تريد حفظها ، فيمكنك أيضًا تمكين سجل تصحيح أخطاء وورد بريس لحفظ كل هذه الرسائل والأخطاء في ملف على الخادم الخاص بك.

عند التمكين عن طريق ضبط WP_DEBUG_LOGالثابت على صحيح ، سيكتب وورد بريس جميع المشكلات إلى الملف التالي:

wp-content/debug.log

ومع ذلك ، يمكنك أيضًا تحديد مسار ملف مخصص لكتابة السجل إلى موقع مختلف على الخادم الخاص بك.

إذا كنت تريد حفظ المشكلات في السجل ولكن لا تريد عرضها علنًا ضمن HTML لصفحاتك (مثل مثال لقطة الشاشة أعلاه) ، يمكنك أيضًا استخدام WP_DEBUG_DISPLAYالثابت للاحتفاظ بوضع التصحيح ممكّنًا ولكن لا يتم عرض الرسائل على موقعك.

عادةً ما تريد أن تتحد WP_DEBUG_DISPLAYمع WP_DEBUG_LOG.

هل أنت جاهز لتصحيح أخطاء موقع #وورد بريس الخاص بك؟ لقد غطت هذا الدليل 🐛

انقر للتغريد

كيفية تمكين وضع تصحيح أخطاء وورد بريس

لتمكين وضع تصحيح أخطاء وورد بريس ، لديك عدة خيارات. سنغطي ثلاث طرق لتمكينه:

كيفية تمكين وضع تصحيح أخطاء وورد بريس في MyKinsta

كيفية استخدام البرنامج المساعد لتصحيح أخطاء وورد بريس

كيفية تمكين وضع تصحيح أخطاء وورد بريس يدويًا

كيفية تمكين وضع تصحيح أخطاء وورد بريس في MyKinsta

إذا كنت تستضيف موقع وورد بريس الخاص بك في Kinsta ، فقد أنشأنا أداة سهلة تتيح لك تمكين وضع تصحيح أخطاء وورد بريس دون الحاجة إلى تحرير ملف wp-config.php الخاص بك .

هذه الأداة ملائمة للقدرة على تمكين وضع التصحيح وعرض الرسائل بسرعة على موقعك ، ولكنها لا تسمح لك بالتحكم في سجل تصحيح أخطاء وورد بريس أو ما إذا كنت تريد عرض الرسائل على الصفحات الحية أم لا. إذا كنت تريد استخدام سجل التصحيح فقط ، فقد تفضل طريقة المكون الإضافي في القسم التالي.

للبدء:

افتح لوحة معلومات MyKinsta الخاصة بك .

حدد الموقع الذي تريد تمكين تصحيح الأخطاء فيه من قائمة المواقع .

انتقل إلى علامة التبويب ” أدوات” في لوحة معلومات هذا الموقع.

انقر فوق ” تمكين” ضمن تصحيح أخطاء وورد بريس.

كيفية تمكين وضع تصحيح أخطاء وورد بريس في MyKinsta

كيفية تمكين وضع تصحيح أخطاء وورد بريس في MyKinsta

يمكنك استخدام الأداة في كل من بيئتك الحية والتشغيل المرحلي. كلما كان ذلك ممكنًا ، نوصي باستخدامه مع بيئة التدريج لأن تمكين وضع تصحيح أخطاء وورد بريس قد يعرض تفاصيل حول كود PHP الخاص بموقعك للزوار (وهو أمر محير للزوار ومخاطر أمنية أيضًا ).

عند الانتهاء ، يمكنك تعطيل وضع التصحيح بالنقر فوق الزر تعطيل في لوحة معلومات Kinsta الخاصة بك:

كيفية تعطيل وضع تصحيح أخطاء وورد بريس في MyKinsta

كيفية تعطيل وضع تصحيح أخطاء وورد بريس في MyKinsta

معلومات

هل ترغب في إجراء اختبار تشغيل MyKinsta؟ أنشئ حسابك التجريبي مجانًا وابدأ في اللعب به.

كيفية استخدام البرنامج المساعد لتصحيح أخطاء وورد بريس

إذا كنت لا تستضيف في Kinsta ، فيمكنك أيضًا العثور على إضافات تصحيح أخطاء وورد بريس المجانية التي تجعل من السهل تمكين وضع التصحيح. هناك العديد من الخيارات في وورد بريس.org ، لكننا نوصي باستخدام المكوّن الإضافي WP Debugging المجاني من Andy Fragen .

WP Debugging وورد بريس plugin

WP Debugging وورد بريس plugin

بمجرد تثبيت البرنامج المساعد وتنشيطه ، يبدأ العمل على الفور. بشكل افتراضي ، يقوم بتعيين الثوابت التالية على صواب (أي أنه يمكّن الميزات التالية):

WP_DEBUG – يتيح وضع التصحيح.

WP_DEBUG_LOG – يحفظ الرسائل في ملف السجل.

SCRIPT_DEBUG

SAVEQUERIES

سنغطي ما فعله الثوابتان الأخيرتان لاحقًا في هذا المنشور.

لتكوين بعض الخيارات ، يمكنك الانتقال إلى Tools → WP Debugging:

الإعدادات خاصة بملحق WP Debugging

إعدادات البرنامج المساعد WP Debugging

بمجرد الانتهاء ، تأكد من تعطيل المكون الإضافي لتعطيل وضع التصحيح.

كيفية تمكين وضع تصحيح أخطاء وورد بريس يدويًا

أخيرًا ، يمكنك أيضًا تمكين وضع تصحيح أخطاء وورد بريس عن طريق إضافة الثوابت يدويًا إلى ملف wp-config.php .

تريد أن تعرف كيف زدنا من حركة المرور لدينا أكثر من 1000 ٪؟

انضم إلى أكثر من 20000 آخرين ممن يتلقون رسائلنا الإخبارية الأسبوعية مع نصائح من الداخل حول وورد بريس!

إشترك الآن

للبدء ، اتصل بالخادم الخاص بك عبر FTP وقم بتحرير ملف wp-config.php . بشكل افتراضي ، يوجد هذا الملف في المجلد الجذر لموقعك (إلا إذا قمت بنقله لأسباب أمنية).

لتمكين وضع تصحيح أخطاء وورد بريس الأساسي فقط ، أضف مقتطف الشفرة التالي أعلى السطر الذي يقول / * هذا كل شيء ، توقف عن التحرير! تدوين سعيد. * /:

// Enable WP_DEBUG mode

define( ‘WP_DEBUG’, true );

يمكنك أيضًا استخدام بعض الثوابت التالية وفقًا لتفضيلاتك:

// Enable Debug logging to the /wp-content/debug.log file

define( ‘WP_DEBUG_LOG’, true );

// Disable display of errors and warnings

define( ‘WP_DEBUG_DISPLAY’, false );

@ini_set( ‘display_errors’, 0 );

بمجرد الانتهاء ، يمكنك إما ضبط الثوابت على false أو إزالة المقتطف لتعطيل وضع التصحيح.

تأكد من تعطيل وضع التصحيح في وورد بريس عند الانتهاء

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

لقد ذكرنا هذا أعلاه – ولكن هذا مجرد تذكير لتعطيل وضع التصحيح دائمًا عند الانتهاء من استكشاف الأخطاء وإصلاحها.

طرق أخرى لتصحيح أخطاء وورد بريس

بالإضافة إلى أداة تصحيح الأخطاء المضمنة التي ذكرناها أعلاه ، هناك العديد من الأدوات الأخرى المضمنة والجهات الخارجية لمساعدتك في تصحيح أخطاء موقع وورد بريس الخاص بك.

تصحيح البرنامج النصي

SCRIPT_DEBUGهو ثابت مضمّن آخر يجبر وورد بريس على استخدام إصدارات المطورين من ملفات CSS الأساسية وملفات JavaScript بدلاً من الإصدارات المصغرة التي يتم تحميلها عادةً.

يمكن أن يكون هذا مفيدًا إذا كنت تختبر التغييرات التي تم إجراؤها على ملفات .js أو .css المضمنة .

هل سئمت من مواجهة مشكلات مع موقع وورد بريس الخاص بك؟ احصل على أفضل وأسرع دعم استضافة مع Kinsta! تحقق من خططنا

للتمكين SCRIPT_DEBUG، يمكنك إما:

استخدم البرنامج المساعد المجاني WP Debugging من الأعلى ، والذي يمكّنه افتراضيًا.

أضف الثابت التالي إلى ملف wp-config.php الخاص بك -define( ‘SCRIPT_DEBUG’, true );

تصحيح استعلام قاعدة البيانات

إذا كنت تواجه مشكلات في قاعدة بيانات موقعك ، فيمكنك تمكين تسجيل استعلام قاعدة البيانات باستخدام SAVEQUERIESالثابت للتتبع:

كل استعلام قاعدة البيانات.

الوظيفة التي تسمى استعلام قاعدة البيانات.

كم من الوقت استغرق الاستعلام.

لتمكين تسجيل الاستعلام ، يمكنك إما:

استخدم البرنامج المساعد المجاني WP Debugging من الأعلى ، والذي يمكّنه افتراضيًا.

أضف الثابت التالي إلى ملف wp-config.php الخاص بك -define( ‘SAVEQUERIES’, true );

ملاحظة: سيؤثر هذا على أداء موقعك ، لذا حاول استخدامه على موقع مرحلي كلما أمكن ذلك وقم بتعطيله بمجرد الانتهاء.

البرنامج المساعد مراقبة الاستعلام

و المساعد مراقب سؤال هو البرنامج المساعد الحرة التي هي مفيدة لتصحيح عدد من المجالات المختلفة في وورد بما في ذلك:

استعلامات قاعدة البيانات.

أخطاء PHP.

الخطافات والإجراءات .

كتل محرر كتلة .

المخطوطات وأوراق الأنماط المطوية.

مكالمات HTTP API .

قدرات المستخدم.

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

بمجرد تثبيت البرنامج المساعد وتنشيطه ، ستحصل على بعض الخيارات الجديدة على شريط أدوات وورد بريس التي تعرض معلومات تصحيح الأخطاء. عند النقر عليها ، ستفتح هذه الخيارات مربعًا جديدًا لمراقبة الاستعلام يمنحك مزيدًا من المعلومات:

البرنامج المساعد مراقبة الاستعلام

البرنامج المساعد مراقبة الاستعلام

للحصول على نظرة أكثر تفصيلاً ، لدينا منشور كامل حول كيفية استخدام المكون الإضافي مراقبة الاستعلام .

بقايا جديدة

New Relic هي أداة متميزة لتحليل وتصحيح أداء موقعك . يمكن أن يساعدك في اكتشاف الاختناقات والمشكلات التي تؤثر على أداء موقعك.

يتضمن Kinsta تكاملًا مدمجًا لمساعدتك في تمكين New Relic بسهولة لموقع وورد بريس الخاص بك ، ولكنك ستظل بحاجة إلى شراء مفتاح ترخيص New Relic الخاص بك.

سجلات الخادم

أخيرًا ، يمكن أن تكون سجلات الخادم أيضًا أداة مفيدة في تصحيح أخطاء وورد بريس.

إذا كنت تستضيف في Kinsta ، فيمكنك عرض جميع سجلات الخادم من علامة التبويب السجلات في لوحة معلومات الموقع:

عرض سجلات الخادم في لوحة معلومات MyKinsta

عرض سجلات الخادم في لوحة معلومات MyKinsta

إذا كنت تستضيف في مكان آخر ، فستحتاج إلى الرجوع إلى وثائق مضيفك لمعرفة أين يمكنك الوصول إلى سجلات الخادم.

حان الوقت لإلقاء نظرة تحت الغطاء وتصحيح موقع #وورد بريس الخاص بك 🐛 يحتوي هذا الدليل على كل ما تحتاجه للبدء 💪

انقر للتغريد

ملخص

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

إذا كنت تستضيف في Kinsta ، فيمكنك تمكينه مباشرة من لوحة القيادة الخاصة بك. بخلاف ذلك ، يمكنك تمكينه باستخدام المكونات الإضافية أو عن طريق إضافة مقتطفات التعليمات البرمجية إلى ملف wp-config.php الخاص بموقعك .

لمزيد من المساعدة ، يمكنك أيضًا استخدام أدوات مضمنة أخرى أو أدوات خارجية مثل New Relic والمكوّن الإضافي المجاني Query Monitor.

هل لديك أي أسئلة أخرى حول كيفية تصحيح أخطاء وورد بريس؟ ترك تعليق وإعلامنا!

وفر الوقت والتكاليف وحقق أقصى قدر من أداء الموقع من خلال:

مساعدة فورية من خبراء استضافة وورد بريس ، 24/7.

تكامل Cloudflare Enterprise.

يصل الجمهور العالمي إلى 28 مركز بيانات حول العالم.

التحسين من خلال مراقبة أداء التطبيقات المضمنة لدينا.