انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

كيف تستخدم Site Health في WordPress لتشخيص متجر متعطل؟

طريقة آمنة لاستخدام Site Health وWP_DEBUG وملف السجل لتشخيص متجر WordPress دون عرض الأخطاء للزوار أو كشف معلومات حساسة.

تعرض شاشة Site Health مؤشرات عن إعداد WordPress والخادم والإضافات والاتصال، لكنها ليست زر إصلاح آلي. فائدتها الحقيقية تظهر عندما تستخدمها لتحديد طبقة المشكلة، ثم تجمع سجلًا محدودًا عبر WP_DEBUG في بيئة آمنة بدل إظهار الأخطاء للزوار.

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

ماذا يعرض Site Health في WordPress؟

توضح وثائق شاشة Site Health وجود تبويب Status للمشكلات الحرجة والتحسينات المقترحة والاختبارات الناجحة، وتبويب Info لمعلومات النظام مثل إصدارات WordPress وPHP والإضافات والقالب والخادم وقاعدة البيانات والصلاحيات.

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

متى تستخدم WP_DEBUG؟

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

في متجر حي لا تعرض الأخطاء للزوار؛ قد تكشف مسارات ملفات أو معلومات تقنية وتشوّه صفحة الدفع. الأفضل إعادة المشكلة في بيئة staging، أو تفعيل سجل مؤقت مع إخفاء العرض وبصلاحيات مناسبة، ثم إيقافه بعد جمع العينة.

راجع مقال تشخيص المهام المجدولة في WooCommerce إذا كانت المشكلة في الطلبات أو الرسائل أو المزامنة؛ Site Health يعطي الصورة العامة، بينما سجل المهام يوضح عمليات الخلفية.

خطوات التشخيص المنظم

  1. وثق العرض: سجل الصفحة والخطوات والوقت والمستخدم ونوع الجهاز، والتقط رسالة الخطأ دون بيانات العميل. لا تبدأ بتعطيل جميع الإضافات على الإنتاج.
  2. راجع Site Health: افتح Tools ثم Site Health. دوّن المشكلات الحرجة ذات الصلة، ثم انسخ معلومات النظام إلى ملف خاص وامسح أي تفاصيل حساسة قبل مشاركته.
  3. أنشئ بيئة اختبار: خذ نسخة احتياطية، وأنشئ staging مماثلًا، وعطّل الرسائل والمدفوعات الحقيقية. أعد المشكلة هناك.
  4. فعّل سجلًا محدودًا: فعّل WP_DEBUG وWP_DEBUG_LOG في بيئة الاختبار، واجعل WP_DEBUG_DISPLAY=false. نفذ الخطوات مرة واحدة ثم اقرأ السجل حول توقيت الاختبار.
  5. اعزل السبب: حدّث أو عطّل عنصرًا واحدًا في كل مرة، وكرر السيناريو. بعد تحديد السبب أعد الإعدادات وأوقف التصحيح.

مثال افتراضي

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

لم يعرض الفريق السجل للعميل، ولم يعطل كل الإضافات على المتجر الحي. التشخيص ربط العرض بتغيير واحد ودليل زمني.

كيف تقرأ السجل دون ضوضاء؟

ابدأ من توقيت الاختبار، وابحث عن Fatal error أو Uncaught ثم راجع الملف والإضافة الظاهرة. التحذيرات المتكررة ليست دائمًا سبب العطل الحالي. قارن آخر سطر قبل توقف الطلب، ثم تحقق مما إذا كان الخطأ يتكرر بنفس الخطوات.

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

ما الذي لا يثبته Site Health؟

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

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

قائمة مراجعة

  • خطوات المشكلة ووقتها موثقة.
  • نسخة احتياطية قابلة للاستعادة موجودة.
  • الاختبار تم في staging قدر الإمكان.
  • تقرير Site Health حُفظ بصورة خاصة.
  • WP_DEBUG_DISPLAY غير ظاهر للزوار.
  • السجل جمع لفترة قصيرة فقط.
  • جرى تغيير عنصر واحد في كل اختبار.
  • الدفع والشحن والرسائل اختبرت بعد الإصلاح.
  • ملفات السجل الحساسة حُذفت أو حُميت.
  • وضع التصحيح أُوقف بعد الانتهاء.
  • سبب الإصلاح وإصدارات الإضافات موثقة.

التشخيص الجيد لا يساوي تشغيل كل أدوات التصحيح في الإنتاج؛ هو جمع أقل قدر من الأدلة اللازمة، في بيئة آمنة، ثم اختبار تغيير واحد يمكن الرجوع عنه.

المراجع والمصادر

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

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.