# ثابت متى أمكن

صفحات معروضة مسبقًا وإعدادات الإنتاج الافتراضية، تُضبط في blockstudio.json.

## اعرض الصفحات المجهولة مسبقًا

العرض المسبق الثابت معطل افتراضيًا. فعّل `performance.staticPrerender`، وسيخزّن Blockstudio مستند HTML كاملًا لكل زائر مجهول، ثم يقدّم النسخة المخزنة للزائر المجهول التالي.

الطلبات التي يجب أن تظل مباشرة لا تستخدمه: طلبات غير GET، وسلاسل الاستعلام، ولوحة الإدارة، وREST، وAjax، وcron، والخلاصات، والبحث، والمعاينات، والصفحات التي تحمل nonce، وكل المسارات تحت `dynamicPaths`، والزوار المسجلون ما لم يكن `serveLoggedIn` مفعّلًا.

[العرض المسبق الثابت](https://blockstudio.dev/ar/docs/production/static-prerendering/)

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## معطّل افتراضيًا

لن يتغير شيء حتى يسمّي blockstudio.json الميزة.

## المسارات الديناميكية

يشمل المسار الديناميكي /account المسار /account/orders، لكنه لا يشمل /accounting.

## علامة استثناء

يمنع تعليق blockstudio:no-cache تخزين أي استجابة مؤقتًا.

## الزوار المسجلون

باستخدام serveLoggedIn، يطّلع الزوار على الصفحات المخزنة؛ أما صفحاتهم الخاصة فلا تُخزّن أبدًا.

## [تجاوز مخصص](https://blockstudio.dev/ar/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

يُبقي المرشح static_prerender/request_bypass أي طلب تحدده، مثل طلب يتضمن ملف تعريف ارتباط لسلة التسوق، خارج الصفحات المخزنة.

## قائمة انتظار التحديث

تعيد قائمة انتظار دائمة عرض الصفحات القديمة وفق الفاصل الزمني الذي تحدده.

## [المسارات طويلة الذيل](https://blockstudio.dev/ar/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

تُقدّم المسارات الواقعة خارج الخريطة المنشورة مبكرًا أيضًا، بمجرد أن يعرضها 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.

[التقديم المبكر](https://blockstudio.dev/ar/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

الطرفية

```
# 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 teardown
```

## تحديث بعد كل تغيير

يملأ وضع `signature` الافتراضي ذاكرة التخزين المؤقت عند عدم العثور على نسخة لزائر مجهول، ويحدّثها بعد التغييرات على مستوى الموقع. يؤدي حفظ منشور أو حذفه إلى مسح ذاكرة ذلك المنشور والصفحة الرئيسية، أو وضعهما في قائمة انتظار لإعادة العرض عند تفعيل التسخين.

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

تقارن عملية تثبيت عنصر البايتات وتستبدل المستندات المتغيرة ذريًا. ويبلغ `last_promotion()` عن عدد المسارات التي رُقّيت أو استُبدلت أو تم تخطيها أو الإبقاء عليها، لتتمكن عملية النشر من تسجيل ذلك ومقارنة معرّف البناء النشط.

[وضْعا التوقيع والرسم البياني](https://blockstudio.dev/ar/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
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']));
```

## خلف CDN

يوضح رأس الاستعراض المسبق بالفعل الاستجابات الآمنة للمشاركة. اربط `HIT` و `HIT-EARLY` بمدة `Cache-Control` عند المصدر الأصلي، وخزّن مؤقتًا ما يحمل واحدة منها فقط، وتجاوز الحافة عند وجود ملفات تعريف الارتباط `wordpress_logged_in_` و `wp-postpass_` و `comment_author_email_` أو `dynamicPaths` أو `wp-admin` أو `wp-json` الخاصة بك.

تظل الصفحات المخزنة مؤقتًا على الحافة مرتبطة بورقة الأنماط ذات تجزئة المحتوى التي عُرضت بها. ارفع `cache.namespaceGrace` إلى أطول مدة يمكن أن تبقى فيها هذه النسخة، وستظل أوراق الأنماط المتقاعدة على القرص حتى تنقضي.

[إعداد CDN](https://blockstudio.dev/ar/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
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;
}
```

## كتلة حية واحدة على صفحة مخزنة مؤقتًا

اضبط `blockstudio.island` على `dynamic`، وستحتوي الصفحة المخزنة مؤقتًا على عنصر نائب بدلًا من الكتلة. يجمع المتصفح كل الجزر الديناميكية في الصفحة ويجلب أجزاءها في طلب مجمّع واحد، مع توقيع كل جزء باسم الكتلة وسماتها المسموح بها.

يُبقي `hydrate` على HTML كاملًا في الصفحة ولا يرسل سوى حدث تركيب. ويمكن للجزر الديناميكية الانتظار حتى تصبح مرئية، والتحديث عند انطلاق حدث نافذة، وتخزين الأجزاء مؤقتًا لكل مستخدم أو على مستوى عام.

[كتل الجزر](https://blockstudio.dev/ar/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## تعرّف على مواضع استهلاك وقت العرض

أضف `?blockstudio-perf` إلى أي URL في الواجهة الأمامية، وستعرض لوحة أوقات العرض لكل كتلة وعدد الاستدعاءات ومراحل التحويل والقالب والمكوّن. وتُرسل التوقيتات نفسها في ترويسات `Server-Timing`، وتظل فعّالة حتى عندما تخزّن CDN قيمة HTML مؤقتًا.

لا يرى المخرجات سوى المستخدمين الذين سجلوا الدخول ولديهم `edit_posts`، بينما يوقف كل طلب آخر أداة تحليل الأداء عند `init`. يضيف `performance.measurement` ترويسات الملف الشخصي وتجزئة الإعدادات، و `Performance_Measurement::snapshot()` API.

[أداة تحليل الأداء](https://blockstudio.dev/ar/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## مفتاح واحد لإعدادات الإنتاج الافتراضية

يؤدي ضبط `performance.profile` على `speed` إلى إزالة مخرجات المولّد والرموز التعبيرية والخلاصات والاكتشاف من الرأس، وتعطيل اكتشاف oEmbed، وإيقاف XML-RPC وعمليات pingback، وإزالة أصول الواجهة الأمامية العامة للنواة، والحد من Heartbeat خارج المحررات، وتحميل روابط النطاق نفسه مسبقًا عند تمرير المؤشر أو التركيز.

القيمة الافتراضية هي `compat`، ولا تغيّر شيئًا. تتجاوز كل قيمة فرعية إعدادات الملف الشخصي، لذا يمكنك الإبقاء على سلوك واحد مع اعتماد بقية الإعدادات.

[ملفات تعريف الأداء](https://blockstudio.dev/ar/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## صور تحجز مساحتها

توجد صور القالب خارج مكتبة الوسائط، لذلك لا يعرف WordPress أبعادها. يقرأ `bs_media_image()` الأبعاد الفعلية من ملف `assets/media.json` مُنشأ ويحجز نسبة العرض إلى الارتفاع قبل تحميل الصورة.

فعّل `performance.media.lazy` ليظل URL الفعلي خلف عنصر نائب مضبوط الأبعاد حتى تقترب الصورة من إطار العرض.

[الوسائط](https://blockstudio.dev/ar/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [مجلد تخزين مؤقت واحد](https://blockstudio.dev/ar/docs/production/caching/)

توجد كل الملفات المُنشأة ضمن cache.path، ويُحدَّد مسارها بهوية وقت التشغيل.

## [عمليات بناء متزامنة](https://blockstudio.dev/ar/docs/production/caching/#concurrency-and-retention)

ينشئ طلب واحد مفتاح ذاكرة تخزين مؤقت باردًا. وتنتظر الطلبات الأخرى أو تعيد استخدام آخر حمولة سليمة أو تتلقى 503 مع Retry-After.

## حمولات ملائمة لـ OPcache

تكون حمولات التخزين المؤقت الصغيرة مصفوفات PHP عادية يمكن لـ OPcache إعادة استخدامها من الذاكرة المشتركة. وتظل الحمولات الأكبر مضغوطة.

## [ذاكرة التخزين المؤقت للعرض](https://blockstudio.dev/ar/docs/production/performance/#render-cache)

يُعرض وسم كتلة ذاتية الإغلاق بالسمات نفسها مرة واحدة لكل طلب. وتُستعاد مرات التكرار من الذاكرة.

## تجميع تحديثات الخيارات

تتحول دفعة من عمليات كتابة المحتوى، مثل الاستيراد، إلى تحديث واحد لخيارات الحقول المعبأة والمخزنة مؤقتًا.

## ذاكرات تخزين مؤقت متعددة المستأجرين

رشّح cache/site_key لتحديد حدود المستأجر الخاصة بك، وcache/context لتحديد متغيرات وقت التشغيل للموقع نفسه.

## [الأصول المترجمة في ذاكرة التخزين المؤقت](https://blockstudio.dev/ar/docs/general/settings/#assets)

عند ضبط assets.output على cache، تخرج الأصول المترجمة من شجرة الكتل، ما يتيح النشر من نسخة عمل ثابتة.

## عمليات بناء مقسمة

يقسم Static_Prerender_Batch_Renderer عملية البناء إلى أجزاء ثابتة N/TOTAL، ويمكن للجهة المستدعية حساب التقسيم نفسه.

## [تضمين أوراق الأنماط الصغيرة](https://blockstudio.dev/ar/docs/blocks/assets/registering/#inline-small-stylesheets)

يطبع assets.inlineLimit أصغر أوراق أنماط الكتل مضمنة ضمن حد للبايتات، مع الحفاظ على ترتيب التتابع نفسه.

## [إضافة كتلة CSS أخيرًا في الرأس](https://blockstudio.dev/ar/docs/blocks/assets/registering/#load-order)

تُضاف كتلة CSS مباشرة قبل وسم إغلاق الرأس، بعد أوراق أنماط القالب والإضافات.

## [تخطي الأصول غير المستخدمة](https://blockstudio.dev/ar/docs/blocks/assets/registering/#disable-enqueuing)

القالب الذي لا يعيد شيئًا لا يضيف أي أصول إلى قائمة الانتظار. ويتيح لك assets.enqueue false التحكم في كل الأصول.

## [أوامر ذاكرة التخزين المؤقت](https://blockstudio.dev/ar/docs/dev/cli/)

تفحص أوامر wp bs cache status وcleanup وclear ذاكرة التخزين المؤقت لوقت التشغيل وتفرغها وتمسحها. ويحذف الأمر wp bs prerender purge الصفحات المخزنة.

## إزالة نظيفة

يزيل wp bs teardown الحالة التي يملكها هذا التثبيت فقط.

## خطافات النتائج

تُرسل cache/outcome وstatic_prerender/outcome تقارير عن مرات الوصول وعمليات البناء والإخفاقات إلى مقاييسك.

## [خطافات الأخطاء](https://blockstudio.dev/ar/docs/blocks/hooks/php/#error-handling)

يوجّه error/logged وerror/exception الأخطاء Blockstudio إلى مسجّل أو أداة تتبّع خارجية.

## [عرض دفعات](https://blockstudio.dev/ar/docs/production/performance/#in-process-batch-rendering)

يمسح Batch_Render::reset() حالة الطلب بين المستندات ضمن عملية واحدة. ويسرد render/dependencies ملفات كل كتلة.

Plus

## حزمة الإضافات الرسمية

قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.

- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص

[احصل على Plus](https://blockstudio.dev/ar/plus/)
