تقديم WordPress كـHTML ثابت
تكون معظم صفحات مواقع التسويق أو التوثيق متطابقة لجميع الزوار غير المسجلين. ومع ذلك، يبدأ WordPress تشغيله، ويحمل كل إضافة، ويشغّل القالب، ويعرض الكتل مع كل طلب. قد تساعد إضافة تخزين الصفحات مؤقتًا، لكنها تضيف عنصرًا آخر بقواعده الخاصة لما يمكن تخزينه بأمان.
يتضمن Blockstudio ميزة عرض مسبق ثابت اختيارية. تخزّن مستندات HTML كاملة للزوار غير المسجلين في مجلد ذاكرة مؤقتة خاص بها، وإذا سمحت بذلك، تعرضها من إضافة advanced-cache.php قبل بدء WordPress. تُضبط جميع الإعدادات في blockstudio.json.
يفعّل هذا الدليل الميزة خطوة بخطوة، ويوضح كيفية التحقق مما يُخزّن مؤقتًا وما لا يُخزّن، ويشرح القاعدة الوحيدة التي تحمي الزوار المسجلين، وينتهي بإعداد CDN لا يخزّن إلا ما يحدده المصدر الأصلي على أنه قابل للتخزين المؤقت.
كيفية تقديم الطلب
عند تفعيل العرض المسبق، ينتهي الطلب المؤهل بإحدى ثلاث نتائج:
- إصابة مبكرة. تعثر الإضافة على مستند مخزّن في خريطة المسارات وترسله قبل تحميل WordPress. يحمل الرد
X-Blockstudio-Static-Prerender: HIT-EARLY. - إصابة. يبدأ WordPress، وعند
template_redirectيعثر Blockstudio على مستند مخزّن حديثًا ويرسله بدلًا من عرض القالب. يحمل الردX-Blockstudio-Static-Prerender: HIT. - عدم إصابة. يعرض WordPress الصفحة كالمعتاد. إذا كان الزائر غير مسجل وكانت النتيجة مستند HTML كاملًا بحالة 200، يخزّنه Blockstudio للطلب التالي.
الطلبات غير المؤهلة لا تصل إلى الذاكرة المؤقتة مطلقًا.
الخطوة 1: تفعيل الإعداد والذاكرة المؤقتة
ابدأ بإعداد الأداء والعرض المسبق، مع إيقاف التقديم المبكر:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"ttl": 86400,
"earlyServe": false,
"dynamicPaths": ["/account", "/checkout", "/login"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4
}
}
}
}
وظيفة كل جزء:
- يفعّل
profile: "speed"الإعدادات الافتراضية لواجهة الإنتاج: تُزال ضوضاء الرأس واكتشاف oEmbed وRPC XML وأصول الواجهة العامة الأساسية، وتُحمّل الروابط من النطاق نفسه مسبقًا عند التفاعل معها. اختبر إعداد إزالة أصول الواجهة الأساسية أولًا، لأن الصفحة التي تعتمد عليها ستتعطل بوضوح. تتجاوز أي قيمة فرعية إعداد الملف الشخصي. - يسجل
staticPrerender.enabledبيئة التشغيل. ما دامfalse، لا تكتب الميزة أي ملفات ولا تسجل خطافات للطلبات. - تحدد
ttlأقصى عمر للمستند المخزّن بالثواني (الافتراضي86400). - تسرد
dynamicPathsبادئات المسارات التي يجب عرضها مباشرة دائمًا. - يجدول
warmأداة تدفئة تعمل في الخلفية، تعيد عرض عناوين URL العامة القديمة كلintervalثانية.
يغطي السطر $schema كل المفاتيح، لذا يرصد محرر يدعم مخطط JSON خطأً مثل "ttl": 0 (الحد الأدنى هو 1).
الخطوة 2: تعرّف على الطلبات المؤهلة
يتوخى Blockstudio الحذر فيما يخزّنه. تتجاوز هذه الطلبات الذاكرة المؤقتة دائمًا:
- أي طلب لا يستخدم
GET - أي URL يتضمن سلسلة استعلام
wp-adminوwp-jsonوwp-login.phpوxmlrpc.phpوAjax وcron- المسارات الخاصة بالخلاصات والبحث والمعاينة
- الطلبات التي ترسل ترويسة
X-WP-Nonce - المسارات ضمن
dynamicPaths - الزوار الذين لديهم ملف تعريف ارتباط
wordpress_logged_in_*أوwp-postpass_*أوcomment_author_email_*، ما لم يكنserveLoggedInمفعّلًا
تُطابق المسارات الديناميكية عند حدود المسار. مع الإعداد أعلاه:
| الطلب | تجاوز الذاكرة المؤقتة |
|---|---|
/pricing/ |
لا |
/account/orders/ |
نعم |
/accounting/ |
لا |
/checkout |
نعم |
/pricing/?utm_source=x |
نعم |
/blog/feed/ |
نعم |
أما عند التخزين، فلا يُحفظ إلا المستند الكامل: يجب أن يبدأ الرد بـ<!doctype html أو <html، وأن تكون حالته 200، وألا يتضمن علامة إلغاء التخزين. يمكن لقالب يجب ألا يُخزّن مطلقًا طباعة العلامة في أي موضع من الصفحة:
<!-- blockstudio:no-cache -->
لا تُخزّن صفحات الخطأ مطلقًا، لذا لا يمكن إعادة عرض صفحة 404 ذات قالب مخصص كأنها نجاح.
الخطوة 3: التحقق من الإصابات
زُر بعض الصفحات في نافذة خاصة، ثم اطلب من Blockstudio إظهار ما يحتويه:
wp bs prerender status
{
"enabled": true,
"invalidate": "signature",
"identity": "e6cdd3fcda14ad6ded85a763bd01a33b",
"cacheRoot": ".../wp-content/blockstudio/cache/sites/.../static-prerender",
"files": 0,
"bytes": 0,
"records": 0,
"queue": {
"pending": 0,
"processing": 0,
"done": 0,
"unique": 0,
"bytes": 0
},
...
"diagnostics": []
}
يزداد files وbytes مع تخزين المستندات، ويعرض queue الأعمال المتبقية لأداة التدفئة، ويحمل diagnostics عدادات الإصابات والإخفاقات وعمليات البناء والأعطال لكل نطاق. للتحقق من صفحة واحدة، اطلبها مرتين بصفتك زائرًا غير مسجل وابحث عن الترويسة:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
يحمل الرد الثاني X-Blockstudio-Static-Prerender: HIT. استخدم GET كما سبق: يرسل curl -I طلبًا من نوع HEAD، وهو يتجاوز الذاكرة المؤقتة دائمًا.
الخطوة 4: التقديم قبل بدء WordPress
بعد التأكد من صحة الإصابات، اضبط "earlyServe": true. عندئذٍ يتولى Blockstudio ثلاثة أجزاء صغيرة من الحالة: إضافة wp-content/advanced-cache.php، وخريطة مسارات wp-content/blockstudio-static-prerender-map.php مشتركة، وتصريح WP_CACHE في wp-config.php. تُثبّت هذه الأجزاء عند طلب الإدارة التالي.
تحافظ بعض القواعد على سلامة ذلك في الاستضافة المشتركة ومتعددة المواقع:
- لا يستبدل Blockstudio أبدًا إضافة التقديم أو الخريطة أو سطر
WP_CACHEالذي لا يملكه. إذا كان مكوّن إضافي آخر للتخزين المؤقت يملكadvanced-cache.phpبالفعل، يظل التقديم المبكر معطّلًا. - إذا كان
WP_CACHEمعرّفًا مسبقًا على أنهtrue، يُتركwp-config.phpكما هو. في الاستضافات التي لا يكون فيهاwp-config.phpقابلًا للكتابة، عرّفه بنفسك. - قبل التقديم، تتحقق كل من إضافة التقديم والمسار PHP من استمرار وجود ملف أنماط Tailwind ذي تجزئة للمحتوى يرتبط به المستند. إذا لم يعد موجودًا، يُوجَّه الطلب إلى WordPress بدلًا من تقديم الصفحة بلا تنسيق.
- تشترك إدخالات المواقع المتعددة في خريطة واحدة، لكنها معزولة بحسب المضيف ومسار الصفحة الرئيسية ومعرّف الموقع.
- تُخزَّن ترويسات الاستجابة المحددة في
replayHeaders، وهيLinkافتراضيًا، مع كل مستند وتُرسل مجددًا عند كل استجابة، لذا تبقى ترويسةLinkالتي ترسلها الصفحة باستخدامheader()عند التقديم المبكر. ولا يُعاد تشغيل ترويسات ملفات تعريف الارتباط أو التخزين المؤقت أبدًا.
تحمل الإصابات المبكرة X-Blockstudio-Static-Prerender: HIT-EARLY. يؤدي إيقاف earlyServe أو enabled إلى إزالة الحالة التي يملكها Blockstudio مرة واحدة، ويزيلها wp bs teardown صراحةً في عمليات تثبيت Composer التي لا يتوفر فيها خطاف إلغاء التفعيل.
الزوار المسجلون والترميز المتطابق
افتراضيًا، يحصل الزوار المسجلون دائمًا على عرض مباشر. يتيح لهم ضبط "serveLoggedIn": true استخدام مستند مخزّن موجود أيضًا، ما يجعل الموقع سريعًا للمحررين والعملاء كما هو للزوار غير المسجلين.
لا تنشئ الردود المخصصة إدخالات في الذاكرة المؤقتة مطلقًا: يُعرض الطلب غير المصاب للزائر المسجل مباشرةً ولا يُخزّن. يسهل إغفال النتيجة التالية: عند تفعيل serveLoggedIn، يحصل الزائر المسجل على المستند المجهول كلما كان موجودًا، ولا يحصل على عرض مباشر مخصص إلا عند غيابه. لذا لا يظهر أي فرع قالب يعتمد على المستخدم الحالي إلا عند عدم الإصابة، وتتغير الصفحة بين الزيارات، ويصبح الفرع المخصص معطّلًا فعليًا في المسارات المخزّنة مؤقتًا.
القاعدة الناتجة: في كل مسار خارج dynamicPaths، يجب أن يكون ترميز الزوار المسجلين مطابقًا بايتًا ببايت لترميز الزوار المجهولين. وهذا يعني عدم استخدام فروع is_user_logged_in() أو wp_get_current_user() في القوالب التي تُعرض على المسارات الثابتة:
<?php // Do not do this on a static route. ?>
<?php if ( is_user_logged_in() ) : ?>
<a href="/account/">Hi, <?php echo esc_html( wp_get_current_user()->display_name ); ?></a>
<?php else : ?>
<a href="/login/">Sign in</a>
<?php endif; ?>
هناك طريقتان واضحتان للحل. انقل المسار إلى dynamicPaths عندما تكون الصفحة بأكملها شخصية، مثل لوحة حساب. أو أبقِ الصفحة ثابتة واعرض الجزء الشخصي كجزيرة كتلة ديناميكية، ترسل عنصرًا نائبًا آمنًا للتخزين ضمن HTML المخزّن، وتجلب المقتطف الحقيقي ضمن طلب الزائر نفسه:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
يبني دليل المقتطفات المخصصة في الصفحات المخزّنة تلك الكتلة.
إبطال التوقيع أو الرسم البياني
يحدد invalidate كيفية انتهاء صلاحية المستندات المخزّنة.
| الجانب | signature (الافتراضي) |
graph |
|---|---|---|
| من يملأ الذاكرة المؤقتة | الطلبات المجهولة غير المصابة وأداة التدفئة | خطوة البناء لديك، بالإضافة إلى الطلبات المجهولة غير المصابة |
| ما الذي يُنهي صلاحية الإدخالات | TTL وحفظ المنشورات وتغييرات مستوى الموقع | عملية بناء جديدة، مع اعتبار TTL حدًا أعلى |
| أداة التدفئة في الخلفية | متاحة | متوقفة |
| يناسب | المواقع العادية | المواقع ذات مسار النشر |
لا يحتاج وضع signature إلى أدوات. يؤدي حفظ منشور إلى مسح الصفحة الرئيسية والرابط الدائم لذلك المنشور أو إعادة تدفئتهما، كما أن تغييرات مستوى الموقع مثل تبديل القالب تغيّر هوية الذاكرة المؤقتة.
وضع graph مخصص للنشر الحتمي. يحسب البناء خطة باستخدام Static_Prerender_Runtime::build_plan()، ويعرض عناوين URL المتأثرة فقط، ويسجل كل نتيجة، ثم يفعّل المجموعة المكتملة ذريًا عبر Static_Prerender_Early_Serve::install_artifact_entry(). إذا فشل التحقق من أي مستند مشار إليه، تظل المجموعة السابقة نشطة. تُقدَّم المسارات المعيّنة من العنصر المُفعّل حتى يستبدله البناء التالي، لذا يصل المحتوى الذي يُعدّل في wp-admin إلى تلك المسارات مع النشر التالي. يكون المُسخّن لكل URL معطلًا في هذا الوضع، لأن العناصر تُبنى وتُفعّل كوحدة واحدة. يبدو إعداد إنتاج نموذجي كما يلي:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
تحدد ttl ذات الثلاثين يومًا فقط الحد الأقصى لعمر المستند المُقدّم. يأتي حداثة المحتوى من عملية النشر التي تعيد بناء الرسم البياني. تتناول وثيقة مرجع العرض المسبق الثابت عملية البناء API وتقسيم البيانات ونقل العرض الداخلي.
وضع CDN أمام الموقع
يخبرك العرض المسبق بالفعل بالاستجابات الآمنة للمشاركة: وهي تحديدًا الاستجابات التي تحمل ترويسة HIT. اجعل المصدر يحولها إلى ترويسة ذاكرة تخزين مؤقت، واجعل CDN يتبع المصدر. مع nginx أمام PHP-FPM:
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}
}
يطابق التعبير النمطي كليهما، HIT وHIT-EARLY. أما في سائر الاستجابات، فتكون قيمة المتغير فارغة، ولا يضيف nginx ترويسة ذات قيمة فارغة؛ لذا تترك حالات عدم العثور والمسارات الديناميكية وعمليات العرض للمستخدمين المسجلين الدخول المصدر بلا مدة تخزين مؤقت مشتركة.
على جانب CDN:
- خزّن HTML مؤقتًا فقط عندما يرسل المصدر مدة تخزين مؤقت. عطّل أي مدة افتراضية في طبقة الحافة للاستجابات التي لا تتضمنها.
- تجاوز طبقة الحافة لنفس ملفات تعريف الارتباط التي يعاملها Blockstudio على أنها شخصية (
wordpress_logged_in_، وwp-postpass_، وcomment_author_email_)، وكذلك لـdynamicPathsوwp-adminوwp-json. - امسح CDN بعد كل عملية نشر تغيّر الصفحات أو القوالب أو الأصول. تتجدد ذاكرة التخزين المؤقت للمصدر تلقائيًا؛ أما طبقة الحافة فلا تعرف أنها بحاجة إلى ذلك.
إذا كنت تستخدم Tailwind مع "output": "link"، فسيكون ملف الأنماط URL ذا مسار يتضمن تجزئة المحتوى، لذا يمكن تقديم هذا المسار بترويسة تخزين مؤقت طويلة الأمد وغير قابلة للتغيير.
أوامر الصيانة
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
يضيف warm عناوين URL العامة القديمة إلى قائمة الانتظار ويعرض ما يصل إلى warm.concurrency منها في كل تشغيل، مع طباعة ملخص JSON. يزيل purge المستندات المخزنة وقائمة الانتظار الخاصة بالموقع الحالي. يزيل teardown أحداث cron والحالة المبكرة للتقديم التي تملكها هذه النسخة، ويترك ملفات الإعداد كما هي.
نفّذ الإطلاق بهذا الترتيب: الملف التعريفي أولًا، ثم العرض المسبق مع إيقاف earlyServe، ثم التقديم المبكر بعد التأكد من أن status والترويسات تبدو صحيحة. يمكن التراجع عن كل طبقة على حدة بإعادة قيمتها إلى ما كانت عليه.
الخطوات التالية
- مرجع العرض المسبق الثابت: إنشاء الرسم البياني وتفعيل العناصر والاحتفاظ بها وخطافات المراقبة.
- الأداء: التغييرات التي يُدخلها ملف تعريف
speedوكيفية قياسها. - التخزين المؤقت: مجلد ذاكرة التخزين المؤقت الذي تُحفظ فيه جميع المستندات.
- الأجزاء المخصصة في الصفحات المخزنة مؤقتًا: محتوى خاص بكل زائر على المسارات الثابتة.
- نشر موقع Blockstudio: موضع مزامنة الصفحات ومسحها وتسخينها ضمن عملية الإصدار.