أدوات تصحيح جديدة للتنمية المحلية

غالبًا ما يبدو تعقب الأخطاء في تطوير WordPress وكأنه يبحث عن إبرة في كومة قش. خاصة عندما تعتمد عليه var_dump() المكالمات ومسح سجلات الأخطاء يدويًا.

يتمتع WordPress Studio بقدرتين جديدتين لتصحيح الأخطاء تجعل هذه العملية أسرع وأكثر سهولة: دعم Xdebug و الوصول إلى سجل التصحيح.

تصحيح الأخطاء خطوة بخطوة باستخدام Xdebug

Xdebug هو امتداد تصحيح أخطاء PHP القياسي. بدلاً من تشتيت مخرجات التصحيح عبر التعليمات البرمجية الخاصة بك، يمكنك تعيين نقاط التوقف، ومتابعة التنفيذ سطرًا تلو الآخر، وفحص المتغيرات في الوقت الفعلي — كل ذلك من المحرر الخاص بك.

هذا متاح الآن لجميع مستخدمي الاستوديو ويتم تشغيله بواسطة ملعب ووردبريس إصدار WebAssembly من PHP، مما يعني أنه لا يوجد أي شيء إضافي لتثبيته أو تهيئته على مستوى النظام.

تمكين برنامج Xdebug

1. حدد الموقع الذي تريد تصحيح أخطائه في الاستوديو.
2. انتقل إلى إعدادات فاتورة غير مدفوعة.
3. انقر تحرير الموقع.
4. انتقل إلى تصحيح الأخطاء فاتورة غير مدفوعة.
5. تحقق من تمكين برنامج Xdebug خانة الاختيار.
6. انقر يحفظ.

سيقوم الاستوديو بإعادة تشغيل الموقع تلقائيًا مع تنشيط Xdebug.

هناك أمران يستحقان أن نضعهما في الاعتبار:

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

توصيل IDE الخاص بك

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

للحصول على دليل الإعداد الكامل، راجع Xdebug في وثائق الاستوديو.

سهولة الوصول إلى سجلات التصحيح

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

يجعل الاستوديو الآن الأمر أسهل بكثير مع تبديل سجل التصحيح المخصص، الذي يحدد WP_DEBUG وWP_DEBUG_LOG لمواقعك تلقائيًا.

تمكين سجل التصحيح في الاستوديو

1. حدد موقعك وانقر تحرير الموقع.
2. افتح تصحيح الأخطاء فاتورة غير مدفوعة.
3. تبديل تمكين سجل التصحيح على.
4. انقر يحفظ.

عند تمكين سجل التصحيح، سيقوم موقعك المحلي بالتقاط أخطاء PHP وإشعاراتها وتحذيراتها في ملف سجل على wp-content/debug.log. سترى بعد ذلك فتح ملف السجل يظهر الرابط في إعدادات علامة التبويب، التي تفتح السجل مباشرة – لا داعي للبحث عن مسار الملف يدويًا.

يمكنك أيضًا كتابة رسائلك الخاصة إلى السجل باستخدام لغة PHP error_log() وظيفة:

error_log( 'My value: ' . print_r( $my_variable, true ) );

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

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

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

سواء كنت تستخدم Claude Code، أو Cursor، أو Codex، فإن الإعداد هو نفسه: أخبر وكيلك بأن سجلات الأخطاء متاحة على wp-content/debug.log. ومن هناك، يمكنه قراءة المخرجات، وتحديد الأخطاء التي تحدث، واقتراح الإصلاحات، كل ذلك دون تعطيل التدفق.

إظهار الأخطاء في المتصفح

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

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

ملاحظة مهمة:”إظهار الأخطاء في المتصفح“من الأفضل استخدامه جنبا إلى جنب سجل التصحيح، وليس كبديل له. إنه أمر رائع للتكرار السريع في بيئتك المحلية، ولكن ستحتاج إلى إيقاف تشغيله على أي موقع تتم مشاركته مع العملاء – يمكنه الكشف عن معلومات المسار الحساسة أو المنطق الداخلي في إخراج الصفحة.

تصحيح أفضل، وإصلاحات أسرع

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

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

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

إذا لم تجرب WordPress Studio بعد، فهذا هو الوقت المناسب للبدء.