انتقل إلى المحتوى

التصيير المسبق الثابت

التصيير المسبق الثابت هو ذاكرة تخزين مؤقت اختيارية للمجهولين من نوع HTML. يجب أن تكون الاستجابة القابلة للتخزين مستندًا كاملًا من نوع HTML، ويمكن استثناؤها باستخدام <!-- blockstudio:no-cache -->. يتجاوز Blockstudio طلبات غير GET، وسلاسل الاستعلام، ولوحة إدارة WordPress، وREST، وAjax، وcron، والخلاصات، ونتائج البحث الواقعة دون مسار البحث الأساسي عند الصفحة الرئيسية للموقع (مثل /search/term/)، وترويسات المعاينة واللوحة، والطلبات الحاوية على nonce، والمسارات الديناميكية المعلنة، وملفات تعريف الارتباط الخاصة بكلمات المرور والتعليقات، والطلبات المسجلة الدخول افتراضيًا. أما الصفحة التي لا يحتوي مسارها إلا على مقطع search أو preview في مستوى أعمق، مثل /docs/blocks/preview/، فتُخزّن كأي صفحة أخرى.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "invalidate": "graph",
      "earlyServe": true,
      "serveLoggedIn": false,
      "dynamicPaths": ["/account", "/checkout"],
      "replayHeaders": ["Link"],
      "warm": {
        "enabled": true,
        "interval": 900,
        "concurrency": 4,
        "transport": "http"
      }
    }
  }
}

لا يمكن للمستخدمين المسجلين الاستفادة من إصابة موجودة إلا إذا كانت serveLoggedIn صحيحة؛ فالاستجابات المخصصة لا تنشئ مدخلات في ذاكرة التخزين المؤقت. وتستخدم المسارات الديناميكية حدود المسار، لذا يطابق /account ‏/account/orders ولا يطابق /accounting.

أثناء تعطيل الميزة، لا تكتب أي ملفات، ولا تثبّت إضافة إسقاط، ولا تسجل خطافات للطلبات أو الإدارة. وبالمثل، لا يسجل earlyServe: false رد نداء إداريًا للتقديم المبكر، ولا يسجل warm.enabled: false رد نداء cron أو جدولًا زمنيًا. يؤدي إيقاف أي من الميزتين إلى إزالة الحالة التي تملكها سابقًا مرة واحدة؛ ولا تجري الطلبات اللاحقة أي عمليات تنظيف لنظام الملفات أو cron.

إيقافها لكل بيئة

يمكن أيضًا تعيين كل قيمة أعلاه باستخدام مرشح إعدادات. يبدأ Blockstudio قبل القالب النشط، من إضافة أو من التحميل التلقائي لـ Composer الخاص بالقالب، لذا يعيد حل إعدادات وقت التشغيل بمجرد تحميل القالب ويحدد خطافات العرض المسبق الثابتة عند after_setup_theme. لذلك يسري مفعول المرشح المضاف بواسطة إضافة أو في functions.php الخاص بالقالب:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
    return 'local' === wp_get_environment_type() ? false : $enabled;
});

يعمل إيقاف الميزة بهذه الطريقة كما لو أوقفتها في blockstudio.json: لا تُسجّل أي خطافات للطلبات أو المحتوى أو الإدارة أو cron، ويُزال إدخال Early Serve مرة واحدة من الموقع الذي كان يُقدّم مبكرًا. لا يغيّر المرشح المضاف لاحقًا، مثلًا على init، الخطافات المسجّلة.

أوضاع التوقيع والرسم البياني

يملأ وضع signature استجابةً مرتبطة بالهوية عند عدم وجود نتيجة لمستخدم مجهول عادي. وهو ملائم لمواقع WordPress المعتادة، ويتجدد بعد التغييرات على مستوى الموقع.

وضع graph مخصص لتكاملات البناء والنشر الحتمية. استدعِ Static_Prerender_Runtime::build_plan() بعناوين URL المصدر الحية، واعرض فقط affectedUrls، ثم سجّل كل نتيجة باستخدام persist_built_response() أو persist_skipped_response(). تقارن الخطة الملفات المشتركة وبصمات التبعيات الدقيقة لكل صفحة. وتزيل عناوين URL المحذوفة وملفات HTML غير المشار إليها بواسطة garbage_collect().

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

$targets = array_keys($plan['live']);
Static_Prerender_Runtime::garbage_collect($targets);

تعيد وسيطات المضيف/الصفحة الرئيسية الاختيارية كتابة المسارات لنشر لا يستخدم مسار الصفحة الأولى جذرًا للموقع. يمكن لأدوات الدُفعات استخدام Static_Prerender_Batch_Renderer::render() وأجزاء N/TOTAL ثابتة؛ ويعتمد خيار الأجزاء على Static_Prerender_Batch_Renderer::parse_shard() وselect_shard()، كي يتمكن المستدعي من حساب التقسيم نفسه الذي سيستخدمه العارض. أثناء البناء، يحدد Static_Prerender_Batch_Renderer::is_rendering() ما إذا كان الطلب الحالي عرضًا ضمن دفعة بدلًا من كونه طلب زائر، ما يتيح للقالب تخطي العمل الذي لا ينبغي تشغيله أثناء البناء. توفّر المرشحة العامة blockstudio/static_prerender/render_internal وسيلة نقل internal؛ ويستخدم الخيار الاحتياطي HTTP ترويسة الإحماء المعتادة.

ما الذي يتتبعه وضع الرسم البياني

مع وسيلة النقل الافتراضية HTTP، ترسل Static_Prerender_Batch_Renderer::render() رمزًا موقّعًا مع كل طلب دافئ، ويُبلغ الطلب عن الملفات التي قرأها: القالب WordPress الذي تم تحميله، وقالب كل كتلة Blockstudio معروضة، وملفات القوالب، وملفات الأصول، والملفات المضافة عبر blockstudio/render/dependencies، وبالنسبة إلى الصفحة المتزامنة، ملفات تعريفها وقالبها ومحتواها وتخطيطها. يُكتب التقرير في دليل ذاكرة التخزين المؤقت للموقع، الذي يشترك فيه العارض وخادم الويب أصلًا لتخزين ملفات HTML المعروضة. في عملية البناء التالية، تعيد build_plan() حساب تجزئات هذه الملفات وتحدد المسارات التي تغيرت ملفاتها فقط، إلى جانب المسارات الجديدة، والمسارات التي تجاوزت ttl، وجميع المسارات عند تغير ملف مشترك (blockstudio.json وtheme.json وstyle.css وfunctions.php وheader.php وfooter.php وكل ما داخل inc/ وparts/ وtemplates/، ومصادر أصول Blockstudio المضمّنة من نوع UI). تحسب التوقيعة المشتركة تجزئات المصادر، لا المخرجات المترجمة، لذا لا تؤثر ملفات _dist التي تترجمها أول عملية عرض في البناء على التوقيعة: تستمد artifact_entry() معرّف البناء من التوقيعة نفسها التي رصدتها build_plan() قبل العرض.

المحتوى الموجود في قاعدة البيانات وحدها ليس ملفًا ولا يُتتبّع: مثل المنشورات المعدّلة في لوحة الإدارة، والخيارات، والصفوف المُنشأة، والأسعار. على البناء الذي يحتاج إلى التقاط هذه التغييرات تمرير $force إلى build_plan() أو عرض عناوين URL المتأثرة بنفسه. وتسجّل وسيلة النقل internal التبعيات التي يعيدها مرشحها.

التقديم المبكر والنشر الذري

عند تفعيل earlyServe، يتولى Blockstudio إدارة wp-content/blockstudio-static-prerender-map.php صغير وملف إسقاط advanced-cache.php وتصريح WP_CACHE محدد. يقرأ ملف الإسقاط خريطة مسارات خاصة بكل موقع ويبث نتيجة مؤهلة قبل بدء WordPress أو الإضافات أو القالب.

لا يستبدل Blockstudio مطلقًا خريطة أو ملف إسقاط أو تصريح WP_CACHE تابعًا لجهة أخرى. تتحقق عناصر الرسم البياني من كل ملف HTML مشار إليه قبل تبديل الخريطة؛ وتبقى الخريطة السابقة فعالة إذا فشل التحقق. تشترك مواقع الشبكة متعددة المواقع في الخريطة، لكن تُعزل حسب المضيف والمسار الرئيسي ومعرّف الموقع. عند تعطيل الميزة أو إلغاء تفعيل Blockstudio، لا يُزال إلا إدخال الموقع الحالي، ولا تُزال العناصر المشتركة إلا بعد اختفاء آخر إدخال مملوك.

يمكن لأدوات النشر تفعيل رسم بياني معروض بالكامل وبشكل ذري:

PHP
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);

Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
    $entry,
    Static_Prerender_Runtime::cache_root_path()
);

يظل الإعداد هو المرجع المعتمد. يعيد install_artifact_entry() القيمة false ما لم يكن كل من enabled وearlyServe صحيحًا، لذا لا يمكن للنشر تثبيت خريطة وملف إسقاط وتصريح WP_CACHE تزيلها لاحقًا أول عملية طلب من الإدارة.

يحتفظ install_artifact_entry() بقيمة build_id الخاصة بالإدخال، كي يقارنها النشر بالقيمة التي يعيدها installed_map_entries() للإدخال لاحقًا. الخريطة ملف PHP يُقرأ باستخدام include، وكل عملية كتابة تزيله من ذاكرة تخزين رموز التشغيل المؤقتة، لذا ترى هذه القراءة الإدخال الجديد في العملية نفسها حتى عند تفعيل opcache.enable_cli.

ينقل تثبيت عنصر إلى نطاق مخصص للأصول لا تمسه عملية اقتطاع الاحتفاظ، كما أن الملفات التي تشير إليها الخريطة محصّنة من الإخلاء أينما وُجدت، لذا لا يمكن لحركة العرض الحية أن تُخرج المسارات المعينة من التقديم المبكر. مفتاح المسار ليس معنونًا بالكامل بحسب المحتوى، لذلك قد يعيد العرض إنشاء مستند بمحتوى مختلف مع بقاء مفتاحه كما هو؛ تقارن عملية التثبيت البايتات وتستبدل ذريًا مستند العنصر المختلف، وتترك المستندات المتطابقة دون تغيير، وتحتفظ بمستند العنصر حتى إن اختفت نسخته المخزنة. يبيّن Static_Prerender_Early_Serve::last_promotion() عدد المسارات التي رُقّيت أو استُبدلت أو تم تخطيها أو الاحتفاظ بها في آخر تثبيت، كي يسجله النشر.

يثبّت المستند المخزّن أصول البناء التي يرتبط بها باستخدام URL، وتحتفظ تلك الملفات بمدة احتفاظها الخاصة، لذا قد يبقى أحدهما بعد زوال الآخر. قبل التقديم، تتحقق كل من ذاكرة التخزين المؤقت لـ PHP وملف الإسقاط من وجود ورقة أنماط Tailwind المرتبطة والمجزأة حسب المحتوى على القرص. يُمرر المستند الذي فُقدت ورقة أنماطه إلى WordPress بدلًا من تقديمه دون تنسيق، ما يؤدي إلى إعادة نشر ورقة الأنماط والمستند معًا. ويُجرى الفحص نفسه قبل تخزين الاستجابة، لذلك لا يُكتب مطلقًا مستند يتعذر تقديمه.

يتجاوز الطلب الذي تحتوي ترويسة Accept فيه على text/markdown كلًا من مخزن PHP وملف الإسقاط، لأن المستندات المخزّنة هي HTML وقد تجيب الصفحة عن ذلك الطلب باستخدام المصدر Markdown. لذلك ترسل المستندات المقدّمة Vary: Accept. يؤدي تحديث Blockstudio إلى إعادة كتابة ملف الإسقاط القديم عند كتابة الخريطة التالية.

تستخدم مسارات الرسم البياني المعينة دائمًا العنصر المُفعّل. إذا لم يكن مسار آمن مجهول في تلك الخريطة، لكن WordPress عرضه وحفظه منذ ذلك الحين، يعود Early Serve إلى مخزن وقت التشغيل المرتبط بالهوية قبل بدء WordPress. يتيح ذلك دعم المسارات المُنشأة أو الطويلة خارج رسم بياني للنشر محدد النطاق عمدًا. يستخدم هذا الخيار الاحتياطي هوية الرسم البياني المُفعّل، وقواعد المضيف وتطبيع المسار ومدة البقاء وملفات تعريف الارتباط والترويسة وسلسلة الاستعلام والمسار الديناميكي وتجاوز الخلاصات نفسها التي تستخدمها المسارات المعينة، ولا يعثر إلا على المستندات التي خزّنها وقت التشغيل، والتي لا تشمل نتائج البحث مطلقًا.

ترويسات الاستجابة

يُعاد تشغيل المستند المخزَّن من دون الطلب الذي أنشأه، لذا ستغيب عن كل استجابة ترويسة يرسلها قالب أو مكوّن إضافي باستخدام header(). يخزّن Blockstudio الترويسات المحددة في replayHeaders مع كل مستند، ثم يرسلها مجددًا من ذاكرة التخزين المؤقت PHP ومن إضافة التقديم المبكر. تشمل القيمة الافتراضية، ["Link"]، ترويسات مثل بديل Markdown من نوع rel="alternate"; type="text/markdown"، أو rel="describedby"، أو rel="canonical". تُطابق الأسماء دون تمييز حالة الأحرف، ويغيّر مرشح الإعداد القائمة كأي قيمة أخرى:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
    $headers[] = 'X-Robots-Tag';

    return $headers;
});

عيّن replayHeaders إلى [] لتعطيل إعادة تشغيل الترويسات. تحل القائمة الصريحة محل الإعداد الافتراضي، لذا أدرج Link عند إضافة أسماء ترويسات أخرى إذا كنت لا تزال تريد إعادة تشغيل ترويسات الروابط.

تُلتقط الترويسات في العملية التي تعرض الصفحة: من headers_list() عند تخزين نتيجة عدم العثور المباشر، ومن طلب الإحماء نفسه عندما ينشئ البناء أو أداة الإحماء العرض فوق HTTP. لذلك لا تُخزَّن أبدًا الترويسة التي يضيفها خادم الويب من تلقاء نفسه ويضيفها مجددًا إلى كل مستند يُقدَّم. ولا تُستخدم ترويسات الاستجابة إلا إذا لم يكتب عرض HTTP أي تقرير. يعيدها ناقل internal في النتيجة على هيئة headers، ويتلقاها persist_built_response() كوسيطة أخيرة، إما على هيئة أسطر Name: value أو خريطة من الأسماء إلى القيم.

تُكتب في <key>.headers.json بجوار المستند، وتنتقل معه خلال ترقية العناصر الناتجة وجمع البيانات المهملة وتقليص مدة الاحتفاظ، وتُزال عندما لا يرسل العرض الجديد أي ترويسات. لا تُخزَّن ترويسات ملفات تعريف الارتباط أو التخزين المؤقت أو النقل ولا يُعاد تشغيلها، حتى عند إدراجها: Set-Cookie، Cache-Control، Expires، Pragma، Age، ETag، Last-Modified، Vary، Content-Type، Content-Length، Content-Encoding، Transfer-Encoding، Location، Status، Date، وكذلك ترويسات القفزة بين الوصلات والمصادقة. ويعيّن المستند المقدَّم قيمتي Content-Type وVary الخاصتين به.

يُعاد التحقق من الترويسات المخزَّنة مقابل القائمة عند إرسالها. تقرأ ذاكرة التخزين المؤقت PHP الإعداد الحالي؛ أما إضافة التقديم المبكر فتقرأ النسخة الموجودة في إدخال خريطة الموقع، ويحدّثها تثبيت العنصر الناتج التالي أو مزامنة الخريطة. لا تحتوي المستندات المخزَّنة قبل الترقية على ملف ترويسات، وتُقدَّم كما كانت تمامًا إلى أن يُعاد عرضها.

الإحماء والصيانة وإمكانية الرصد

قائمة انتظار الإحماء دائمة، وتدمج الطلبات المتطابقة حسب URL، وتنفذ مهمة واحدة لكل مرة، وتستعيد المطالبات التي انتهت مهلتها. تفرض تغييرات المحتوى والموقع مهمة بديلة حتى عندما لا يتغير التوقيع الحالي؛ أما عمليات الإحماء الدورية فتضيف المهام القديمة فقط. تنفذ كل دورة، مجدولة كانت أم عبر wp bs prerender warm، ما يصل إلى warm.concurrency مهام. يعطّل وضع graph الإحماء لكل URL، لأن عناصر الرسم البياني تُبنى وتُفعّل كوحدة واحدة.

سطر الأوامر
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run

يعرض status الهوية النشطة والملفات والبايتات وسجلات الرسم البياني وحالة قائمة الانتظار وتقرير خريطة التقديم المبكر وعدادات الإصابة/الإخفاق/البناء/الفشل لكل نطاق.

تُشارك جميع مواقع التثبيت خريطة التقديم المبكر. تعرض map status (وStatic_Prerender_Early_Serve::map_report()) الإدخالات التي لم يعد التقديم المبكر قادرًا على استخدامها: إدخالات orphaned لم تعد مواقعها موجودة، وإدخالات dead لم تعد مجلداتها موجودة، إضافة إلى عدد مستندات المسارات missing في الإدخالات المتبقية. تزيل map prune (Static_Prerender_Early_Serve::prune_map()) الإدخالات اليتيمة والمنتهية تحت قفل الخريطة وتذكر سبب كل منها؛ أما --dry-run فيكتفي بعرضها. تؤدي إزالة آخر إدخال إلى إزالة الخريطة وملف الإسقاط وتصريح WP_CACHE. يُزيل حذف موقع من شبكة متعددة المواقع إدخالاته فورًا، ولا تجمع عملية تنظيف ذاكرة التخزين المؤقت النطاق الذي يُقدَّم منه عنصر مُفعّل، لذا لا تنتهي صلاحية الإدخالات إلا عند إزالة ملفاتها بوسائل أخرى.

راقب نتائج الاستجابات الفردية باستخدام blockstudio/static_prerender/outcome ونتائج ذاكرة التخزين المؤقت المشتركة كلها باستخدام blockstudio/cache/outcome.

إزالة التثبيت

يمكن للتثبيتات التي لا تحتوي على خطاف لإلغاء تفعيل إضافة، مثل الإعدادات المضمّنة عبر Composer، إزالة كل ما تملكه الميزة بأمر واحد:

سطر الأوامر
wp bs teardown

يزيل أحداث cron وحالة العرض المسبق الثابتة التي يملكها التثبيت: إدخال الخريطة للموقع الحالي، وملف الإسقاط المشترك وتصريح WP_CACHE بعد زوال آخر إدخال مملوك. وتُترك ملفات الإعداد دون تغيير، لذا يبدأ تفعيل الميزة مجددًا بسلاسة.

اعتماده في بيئة الإنتاج

ترتيب مناسب للتبني:

  1. عيّن performance.profile إلى speed، ثم تحقق من مخرجات head والخلاصات وأي إضافة تعتمد على oEmbed أو XML-RPC.
  2. أنشئ assets/media.json، وانقل القوالب إلى bs_media_image()، ثم فعّل performance.media.lazy.
  3. فعّل performance.staticPrerender مع إيقاف earlyServe، وتحقق من النتائج باستخدام wp bs prerender status، ثم فعّل earlyServe.

يُنفّذ التراجع لكل ميزة على حدة: يؤدي تعيين staticPrerender.enabled إلى false إلى إزالة حالة Early Serve الخاصة بـ Blockstudio وجداول الإحماء مرة واحدة، ثم يترك بيئة العرض المسبق غير مسجّلة. ويؤدي تعيين performance.profile مجددًا إلى compat إلى التراجع عن ملف التعريف. ويُبقي كل إجراء الطبقات الأخرى كما هي.

الأداء

ملفات التعريف وأداة تحليل الأداء وتقنيات العرض المستخدمة.

التخزين المؤقت

مجلد ذاكرة التخزين المؤقت الوحيد الذي يحوي كل عنصر مُنشأ.