تُبلغ أداة Site Health في ووردبريس أحياناً بأن REST API أعطت خطأً أو أن loopback فشل. ويعني ذلك أن الخادم لا يستطيع إرسال طلب إلى عنوانه هو. وهذا يؤثر على مهام cron والتحديثات وبعض الإضافات. يعرض هذا الدليل الطريقة الدقيقة لإيجاد السبب.
١. أعيدوا إنتاج المشكلة من الخادم
wp eval 'var_dump( wp_remote_get( home_url( "/wp-json/" ) ) );'
إذا كان الناتج WP_Error فسترون الرسالة الدقيقة (مثل cURL error 28 انتهاء المهلة أو 60 مشكلة شهادة)؛ وإن كان مصفوفة فاقرأوا رمز الاستجابة. هذا هو الطلب نفسه الذي ينفذه Site Health.
٢. curl من داخل الخادم
curl -sI https://example.com/wp-json/ | head -n 5
getent hosts example.com
إذا فشل curl أيضاً فالمشكلة ليست في ووردبريس بل في الشبكة أو خادم الويب. وبـ getent انظروا إلى أي IP يُحلّ النطاق من الداخل؛ أحياناً يكون العنوان العام ولا يسمح الجدار الناري بالاتصال بالنفس.
٣. أسباب شائعة
- جدار ناري أو سياسة NAT تمنع الخادم من الوصول إلى عنوانه العام.
- Basic Auth أو تقييد IP على الموقع كله أو على wp-json.
- إضافة أمنية تغلق REST للمستخدم المجهول.
- Cloudflare أو WAF يتحدى طلبات الخادم.
- شهادة غير صالحة أو سلسلة ناقصة.
٤. الحلول
عند مشكلة DNS الداخلي فإن إدخالاً في /etc/hosts يوجّه النطاق إلى 127.0.0.1 يجعل الطلب محلياً (فقط إذا كان خادم الويب على الجهاز نفسه). وإلا فاسمحوا بالعنوان في الجدار الناري. ويعتمد WP-Cron على loopback نفسه. ولمشكلات الشهادة راجعوا قسم TLS في إعداد TLS.
٥. التأكيد
شغّلوا Site Health مجدداً واستخدموا wp cron event run --due-now للتأكد من تنفيذ مهام cron.
٦. مثال توضيحي وليس قياساً حقيقياً
لنفترض أن Site Health أبلغ عن خطأ loopback. أظهر wp eval الخطأ cURL error 28 وأعاد getent العنوان العام الذي يرفضه الجدار الناري للحركة الداخلية. وحلّت إضافة إدخال hosts المشكلة. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.
٧. أخطاء شائعة
- تعطيل REST API بدل إيجاد السبب.
- تجاهل التحذير وفقدان مهام cron.
- الاختبار من متصفحكم فقط (شبكة مختلفة).
- تعديل /etc/hosts دون معرفة أن خادم الويب على الجهاز نفسه.
٨. أسئلة شائعة
ما هو loopback؟ طلب من الخادم إلى عنوانه العام.
يفتح في متصفحي فلماذا التحذير؟ يختلف مسار الخادم إلى نفسه عن مسار متصفحكم.
هل أعطّل REST API؟ لا؛ فمحرر الكتل وإضافات كثيرة تحتاجها.
٩. قائمة تحقق سريعة
- نُفذ wp_remote_get من الخادم.
- اختُبر curl من الخادم.
- فُحص DNS الداخلي.
- روجع الجدار الناري/WAF وBasic Auth.
- أُكّد Site Health وcron مجدداً.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
ووردبريس: wp_remote_get() · ووردبريس REST API handbook · ووردبريس: Site Health
