كل المقالات التقنية

التحكم في Heartbeat وحمل admin-ajax في ووردبريس بأمان

قياس طلبات admin-ajax.php وHeartbeat وإبطاء الفترة وإيقافه خارج المحرر وتجنب حجب admin-ajax بالخطأ.

التحكم في Heartbeat وحمل admin-ajax في ووردبريس بأمان

كل تبويب مفتوح من لوحة تحكم ووردبريس يرسل بهدوء طلبات إلى admin-ajax.php، وعلى خطة استضافة صغيرة قد تتحول هذه الطلبات إلى استهلاك فعلي للمعالج. معظمها يأتي من Heartbeat API، وهي ميزة مدمجة تُبقي المحرر وقفل المقالات وفحص الجلسة حيّة. وهي مفيدة، لكنها طلب يتجاوز ذاكرة الصفحات دائمًا. يوضح هذا الدليل كيف تقيس الحمل أولًا، وكيف تُبطئ Heartbeat أو توقفه حيث لا حاجة إليه، وكيف تتجنب الخطأ الشائع بحجب admin-ajax.php نفسه الذي يعطّل النماذج وسلات الشراء.

١. ماذا يفعل Heartbeat بالضبط

Heartbeat جزء صغير من JavaScript يرسل طلب POST بالمعامل action=heartbeat إلى /wp-admin/admin-ajax.php على فترات منتظمة. يستخدمه ووردبريس لقفل المقالات (كي لا يكتب محرران فوق عمل بعضهما)، وللحفظ التلقائي في المحرر، وللتنبيه بانتهاء جلسة الدخول. وتضيف بعض الإضافات بياناتها إليه، مثل أعداد الطلبات الحية. الفترات عادة أقصر في محرر المقالات وأطول في بقية اللوحة، ويبطئها المتصفح عندما يكون التبويب في الخلفية. وقد تختلف القيم الافتراضية بين الإصدارات، فاعتبر ما تراه في متصفحك هو المرجع.

المهم للأداء أن كل نبضة طلب PHP كامل يحمّل ووردبريس. وهو طلب POST فلا تجيب عنه ذاكرة الصفحات. تبويب واحد غير مؤذٍ، لكن تبويبات كثيرة تبقى مفتوحة ساعات على خطة مشتركة ليست كذلك، وهي أحد العوامل الشائعة للحدود المشروحة في حل خطأ 508 Resource Limit Reached في cPanel.

٢. قِس قبل أن تغيّر شيئًا

افتح أدوات المطور في المتصفح وانتقل إلى تبويب Network وصفِّ بـadmin-ajax وراقب دقيقة. انقر على طلب واقرأ الحمولة: action=heartbeat يعني Heartbeat، وأي قيمة أخرى تعني أن إضافة أو قالبًا يستدعي هذا العنوان. ثم احسب ما يراه الخادم فعلًا:

# Log paths differ by host; adjust access.log (combined format assumed)
grep -c 'POST /wp-admin/admin-ajax.php' access.log
grep 'POST /wp-admin/admin-ajax.php' access.log | awk '{print $1}' | sort | uniq -c | sort -rn | head

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

٣. اعرف من يستدعي admin-ajax.php أيضًا

Heartbeat ليس المستدعي الوحيد. نماذج الاتصال وأجزاء السلة واقتراحات البحث ومنشئو الصفحات وبعض إضافات الإحصاء تستخدم admin-ajax.php كذلك، حتى في الموقع العام. قارن قيم action= في تبويب Network وأنت تتصفح الواجهة كزائر. الإضافة التي تستعلم العنوان كل بضع ثوانٍ هدف أفضل من Heartbeat. ويساعدك محلل أداء مثل Query Monitor على معرفة الإضافة التي تعالج طلبًا معينًا، كما في تقليل TTFB في ووردبريس: ذاكرة الصفحات وOPcache والإضافات البطيئة.

٤. أبطئ الفترة

أخف تغيير هو إطالة الفترة لتتصل التبويبات أقل. ضعه في إضافة must-use لا في القالب كي يبقى بعد تغيير القالب:

<?php
// wp-content/mu-plugins/heartbeat-interval.php
add_filter('heartbeat_settings', function ($settings) {
    $settings['interval'] = 60; // seconds; the allowed range is roughly 15 to 120
    return $settings;
});

أنشئ الملف في wp-content/mu-plugins/ وأعد تحميل اللوحة وافحص Network من جديد. يستمر المحرر في العمل لكن بنبضات أقل، فيستجيب القفل والحفظ التلقائي أبطأ قليلًا. ابدأ بـ٦٠ ثانية ولا تذهب إلى الحد الأقصى دون سبب، لأن الفترات الطويلة جدًا تؤخر تحذير القفل.

٥. أوقف Heartbeat خارج المحرر

إذا كانت المشكلة في تبويبات اللوحة فيمكنك إبقاء Heartbeat في الشاشات التي تحتاجه فقط. يزيل هذا النمط السكربت في كل مكان عدا محرر المقالات:

<?php
// wp-content/mu-plugins/heartbeat-editor-only.php
add_action('init', function () {
    global $pagenow;
    $is_editor = in_array($pagenow, array('post.php', 'post-new.php'), true);
    if (!$is_editor) {
        wp_deregister_script('heartbeat');
    }
}, 1);

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

٦. لا تحجب admin-ajax.php

يغري حجب الملف في خادم الويب أو جدار الحماية. لا تفعل. يستخدمه الموقع العام لإرسال النماذج وتحديث السلة وميزات كثيرة في الإضافات، وحجبه يفشل بصمت أمام الزوار. إذا كان عنوان واحد يسيء استخدامه فقيّد ذلك العنوان أو احجبه، كما في تحصين تسجيل الدخول في ووردبريس: الحد من المعدل وXML-RPC والمصادقة الثنائية، واترك العنوان نفسه مفتوحًا. وقد يسمح ملف robots.txt بهذا المسار للسبب نفسه.

٧. تحقق من النتيجة وأبقِ طريق رجوع

بعد ٢٤ ساعة كرّر العدّ نفسه على نوع الفترة نفسه من السجل وقارنه بخط الأساس. افتح اللوحة في تبويبين وعدّل مقالة وتأكد أن المحرر ما زال يحفظ ويعرض تنبيه القفل. وإن حدث خلل فأزل الملف:

# Rollback: remove the file you added, then confirm it is gone
rm wp-content/mu-plugins/heartbeat-editor-only.php
ls wp-content/mu-plugins/

لأن التغيير في ملف منفصل فلا يُمس شيء آخر. دوّن التاريخ والعدد السابق والعدد الجديد.

٨. مثال تطبيقي

هذا المثال توضيحي وليس قياسًا لموقع حقيقي. تخيّل عشرة محررين يترك كل منهم تبويب لوحة مفتوحًا طوال اليوم. بطلب واحد في الدقيقة يصبح الناتج ١٠ × ١٬٤٤٠ = ١٤٬٤٠٠ طلب يوميًا إلى عنوان لا تستطيع الذاكرة المؤقتة خدمته. إيقاف Heartbeat خارج المحرر يزيل معظمها وتبقى تبويبات المحرر تعمل. وكون ذلك مهمًا أم لا يتوقف على خطتك: على حساب مشترك صغير قد يظهر الأثر، وعلى خادم مخصص كبير قد يكون ضجيجًا. لذلك تقيس أولًا.

٩. الأخطاء الشائعة

  • تعطيل Heartbeat في كل مكان بما فيه المحرر وفقدان قفل المقالات.
  • حجب admin-ajax.php في جدار الحماية وتعطيل النماذج أو السلة.
  • وضع الشيفرة في functions.php الخاص بالقالب فتختفي مع تحديث القالب.
  • تغيير الإعداد دون خط أساس فلا تعرف إن كان نفع.
  • افتراض أن Heartbeat هو السبب بينما تستدعي إضافة أخرى العنوان أكثر منه بكثير.

١٠. أسئلة شائعة

هل ترسل الواجهة العامة Heartbeat؟ ليس افتراضيًا، لكن قالبًا أو إضافة قد تحمّله. يوضح تبويب Network في صفحة عامة ذلك.

هل إضافة Heartbeat أفضل من الشيفرة؟ بعض إضافات الأداء تتضمن تحكمًا في Heartbeat ولا بأس بها. النتيجة واحدة، لكن الشيفرة أسهل مراجعة وإزالة.

هل يضر بالسيو؟ لا. Heartbeat ميزة للوحة التحكم ولا يطلقها الزوار ولا محركات البحث.

هل أحتاج إلى تفعيل الملف؟ لا. تُحمَّل ملفات mu-plugins تلقائيًا فلا يوجد مفتاح تشغيل. ولهذا السبب قد يعطّل خطأ نحوي في أحدها الموقع كله، فافحصه بـphp -l file.php قبل الرفع.

هل يخزّن CDN أو جدار الحماية هذه الطلبات؟ عادة لا، لأنها طلبات POST. وقد تحسبها بعض جدران الحماية ضمن حد المعدل، فراجع القواعد إن حُجب المديرون.

ماذا لو توقفت إضافة عن تحديث البيانات الحية؟ أعد Heartbeat في تلك الشاشة أو أزل الملف ثم اسأل مطور الإضافة هل تدعم فترة أطول.

١١. قائمة تحقق سريعة

  1. سجّل عدد طلبات POST إلى admin-ajax.php كخط أساس.
  2. افحص قيم action= لتعرف من يستدعي العنوان.
  3. أطل الفترة أولًا في إضافة must-use.
  4. أوقف Heartbeat خارج المحرر فقط إذا كانت المشكلة في التبويبات.
  5. لا تحجب admin-ajax.php عن الجميع.
  6. أعد العدّ بعد يوم ودوّن مسار ملف التراجع.

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

تجد مزيدًا من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

ووردبريس: Heartbeat API · Hook: heartbeat_settings · ووردبريس: AJAX in plugins · Must-use plugins