ثابت متى أمكن
صفحات معروضة مسبقًا وإعدادات الإنتاج الافتراضية، تُضبط في blockstudio.json.
اعرض الصفحات المجهولة مسبقًا
العرض المسبق الثابت معطل افتراضيًا. فعّل performance.staticPrerender، وسيخزّن Blockstudio مستند HTML كاملًا لكل زائر مجهول، ثم يقدّم النسخة المخزنة للزائر المجهول التالي.
الطلبات التي يجب أن تظل مباشرة لا تستخدمه: طلبات غير GET، وسلاسل الاستعلام، ولوحة الإدارة، وREST، وAjax، وcron، والخلاصات، والبحث، والمعاينات، والصفحات التي تحمل nonce، وكل المسارات تحت dynamicPaths، والزوار المسجلون ما لم يكن serveLoggedIn مفعّلًا.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>معطّل افتراضيًا
لن يتغير شيء حتى يسمّي blockstudio.json الميزة.
المسارات الديناميكية
يشمل المسار الديناميكي /account المسار /account/orders، لكنه لا يشمل /accounting.
علامة استثناء
يمنع تعليق blockstudio:no-cache تخزين أي استجابة مؤقتًا.
الزوار المسجلون
باستخدام serveLoggedIn، يطّلع الزوار على الصفحات المخزنة؛ أما صفحاتهم الخاصة فلا تُخزّن أبدًا.
تجاوز مخصص
يُبقي المرشح static_prerender/request_bypass أي طلب تحدده، مثل طلب يتضمن ملف تعريف ارتباط لسلة التسوق، خارج الصفحات المخزنة.
قائمة انتظار التحديث
تعيد قائمة انتظار دائمة عرض الصفحات القديمة وفق الفاصل الزمني الذي تحدده.
المسارات طويلة الذيل
تُقدّم المسارات الواقعة خارج الخريطة المنشورة مبكرًا أيضًا، بمجرد أن يعرضها WordPress ويخزنها.
فحص ورقة الأنماط
تُعاد تهيئة أي صفحة مخزنة فُقدت ورقة الأنماط Tailwind المرتبطة بها، ولا تُعرض أبدًا بلا أنماط.
يُقدّم قبل تشغيل WordPress
عند تفعيل earlyServe، يثبّت Blockstudio إضافة drop-in من نوع advanced-cache.php ترسل الصفحة المخزنة قبل تحميل WordPress أو الإضافات أو القالب. ولا يستبدل أبدًا إضافة drop-in أو خريطة مسارات أو سطرًا في WP_CACHE لم يكتبه.
هذا الموقع يشغّله. في 8 أكتوبر 2026، أجابت صفحات blockstudio.dev برمز x-blockstudio-static-prerender: HIT-EARLY، وهو الترويسة التي ترسلها إضافة drop-in.
# Identity, files, queue, and hit/miss counters
wp bs prerender status
# Re-render stale entries now
wp bs prerender warm
# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run
# Remove the drop-in and map this install owns
wp bs teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYتحديث بعد كل تغيير
يملأ وضع signature الافتراضي ذاكرة التخزين المؤقت عند عدم العثور على نسخة لزائر مجهول، ويحدّثها بعد التغييرات على مستوى الموقع. يؤدي حفظ منشور أو حذفه إلى مسح ذاكرة ذلك المنشور والصفحة الرئيسية، أو وضعهما في قائمة انتظار لإعادة العرض عند تفعيل التسخين.
وضع graph مخصص لأدوات النشر. فهو يسجل الملفات التي قرأتها كل صفحة، بحيث تعيد عملية البناء عرض المسارات التي تغيرت ملفاتها فقط، ثم تفعّل المجموعة الجديدة كعنصر واحد. وإذا تعذر التحقق من صحة ملف مشار إليه، يظل العنصر السابق قيد التشغيل.
تقارن عملية تثبيت عنصر البايتات وتستبدل المستندات المتغيرة ذريًا. ويبلغ last_promotion() عن عدد المسارات التي رُقّيت أو استُبدلت أو تم تخطيها أو الإبقاء عليها، لتتمكن عملية النشر من تسجيل ذلك ومقارنة معرّف البناء النشط.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();خلف CDN
يوضح رأس الاستعراض المسبق بالفعل الاستجابات الآمنة للمشاركة. اربط HIT وHIT-EARLY بمدة Cache-Control عند المصدر الأصلي، وخزّن مؤقتًا ما يحمل واحدة منها فقط، وتجاوز الحافة عند وجود ملفات تعريف الارتباط wordpress_logged_in_ وwp-postpass_ وcomment_author_email_ أو dynamicPaths أو wp-admin أو wp-json الخاصة بك.
تظل الصفحات المخزنة مؤقتًا على الحافة مرتبطة بورقة الأنماط ذات تجزئة المحتوى التي عُرضت بها. ارفع cache.namespaceGrace إلى أطول مدة يمكن أن تبقى فيها هذه النسخة، وستظل أوراق الأنماط المتقاعدة على القرص حتى تنقضي.
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}كتلة حية واحدة على صفحة مخزنة مؤقتًا
اضبط blockstudio.island على dynamic، وستحتوي الصفحة المخزنة مؤقتًا على عنصر نائب بدلًا من الكتلة. يجمع المتصفح كل الجزر الديناميكية في الصفحة ويجلب أجزاءها في طلب مجمّع واحد، مع توقيع كل جزء باسم الكتلة وسماتها المسموح بها.
يُبقي hydrate على HTML كاملًا في الصفحة ولا يرسل سوى حدث تركيب. ويمكن للجزر الديناميكية الانتظار حتى تصبح مرئية، والتحديث عند انطلاق حدث نافذة، وتخزين الأجزاء مؤقتًا لكل مستخدم أو على مستوى عام.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));تعرّف على مواضع استهلاك وقت العرض
أضف ?blockstudio-perf إلى أي URL في الواجهة الأمامية، وستعرض لوحة أوقات العرض لكل كتلة وعدد الاستدعاءات ومراحل التحويل والقالب والمكوّن. وتُرسل التوقيتات نفسها في ترويسات Server-Timing، وتظل فعّالة حتى عندما تخزّن CDN قيمة HTML مؤقتًا.
لا يرى المخرجات سوى المستخدمين الذين سجلوا الدخول ولديهم edit_posts، بينما يوقف كل طلب آخر أداة تحليل الأداء عند init. يضيف performance.measurement ترويسات الملف الشخصي وتجزئة الإعدادات، وPerformance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();مفتاح واحد لإعدادات الإنتاج الافتراضية
يؤدي ضبط performance.profile على speed إلى إزالة مخرجات المولّد والرموز التعبيرية والخلاصات والاكتشاف من الرأس، وتعطيل اكتشاف oEmbed، وإيقاف XML-RPC وعمليات pingback، وإزالة أصول الواجهة الأمامية العامة للنواة، والحد من Heartbeat خارج المحررات، وتحميل روابط النطاق نفسه مسبقًا عند تمرير المؤشر أو التركيز.
القيمة الافتراضية هي compat، ولا تغيّر شيئًا. تتجاوز كل قيمة فرعية إعدادات الملف الشخصي، لذا يمكنك الإبقاء على سلوك واحد مع اعتماد بقية الإعدادات.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}صور تحجز مساحتها
توجد صور القالب خارج مكتبة الوسائط، لذلك لا يعرف WordPress أبعادها. يقرأ bs_media_image() الأبعاد الفعلية من ملف assets/media.json مُنشأ ويحجز نسبة العرض إلى الارتفاع قبل تحميل الصورة.
فعّل performance.media.lazy ليظل URL الفعلي خلف عنصر نائب مضبوط الأبعاد حتى تقترب الصورة من إطار العرض.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}مجلد تخزين مؤقت واحد
توجد كل الملفات المُنشأة ضمن cache.path، ويُحدَّد مسارها بهوية وقت التشغيل.
عمليات بناء متزامنة
ينشئ طلب واحد مفتاح ذاكرة تخزين مؤقت باردًا. وتنتظر الطلبات الأخرى أو تعيد استخدام آخر حمولة سليمة أو تتلقى 503 مع Retry-After.
حمولات ملائمة لـ OPcache
تكون حمولات التخزين المؤقت الصغيرة مصفوفات PHP عادية يمكن لـ OPcache إعادة استخدامها من الذاكرة المشتركة. وتظل الحمولات الأكبر مضغوطة.
ذاكرة التخزين المؤقت للعرض
يُعرض وسم كتلة ذاتية الإغلاق بالسمات نفسها مرة واحدة لكل طلب. وتُستعاد مرات التكرار من الذاكرة.
تجميع تحديثات الخيارات
تتحول دفعة من عمليات كتابة المحتوى، مثل الاستيراد، إلى تحديث واحد لخيارات الحقول المعبأة والمخزنة مؤقتًا.
ذاكرات تخزين مؤقت متعددة المستأجرين
رشّح cache/site_key لتحديد حدود المستأجر الخاصة بك، وcache/context لتحديد متغيرات وقت التشغيل للموقع نفسه.
الأصول المترجمة في ذاكرة التخزين المؤقت
عند ضبط assets.output على cache، تخرج الأصول المترجمة من شجرة الكتل، ما يتيح النشر من نسخة عمل ثابتة.
عمليات بناء مقسمة
يقسم Static_Prerender_Batch_Renderer عملية البناء إلى أجزاء ثابتة N/TOTAL، ويمكن للجهة المستدعية حساب التقسيم نفسه.
تضمين أوراق الأنماط الصغيرة
يطبع assets.inlineLimit أصغر أوراق أنماط الكتل مضمنة ضمن حد للبايتات، مع الحفاظ على ترتيب التتابع نفسه.
إضافة كتلة CSS أخيرًا في الرأس
تُضاف كتلة CSS مباشرة قبل وسم إغلاق الرأس، بعد أوراق أنماط القالب والإضافات.
تخطي الأصول غير المستخدمة
القالب الذي لا يعيد شيئًا لا يضيف أي أصول إلى قائمة الانتظار. ويتيح لك assets.enqueue false التحكم في كل الأصول.
أوامر ذاكرة التخزين المؤقت
تفحص أوامر wp bs cache status وcleanup وclear ذاكرة التخزين المؤقت لوقت التشغيل وتفرغها وتمسحها. ويحذف الأمر wp bs prerender purge الصفحات المخزنة.
إزالة نظيفة
يزيل wp bs teardown الحالة التي يملكها هذا التثبيت فقط.
خطافات النتائج
تُرسل cache/outcome وstatic_prerender/outcome تقارير عن مرات الوصول وعمليات البناء والإخفاقات إلى مقاييسك.
خطافات الأخطاء
يوجّه error/logged وerror/exception الأخطاء Blockstudio إلى مسجّل أو أداة تتبّع خارجية.
عرض دفعات
يمسح Batch_Render::reset() حالة الطلب بين المستندات ضمن عملية واحدة. ويسرد render/dependencies ملفات كل كتلة.
حزمة الإضافات الرسمية
قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.
- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص