التخزين المؤقت
Blockstudio يتضمن ذاكرات تخزين مؤقت دائمة مستندة إلى الملفات. وهي مفعّلة افتراضيًا عبر الإعداد cache.enabled، وتُكتب في:
wp-content/blockstudio/cache/
يحتفظ هذا الجذر المُعدّ بحمولات بناء وقت التشغيل، وبيانات تسجيل الكتل المُنشأة مسبقًا، وأصول المحرر، وTailwind CSS، والمستندات المُصيّرة، وأجزاء الجزر، وHTML الثابتة، وفهارس الرسوم البيانية، وقوائم الانتظار الدافئة، وتشخيصات التخزين المؤقت. وهذا يجنب تكرار أعمال الاكتشاف والتحليل والتجميع والتصيير، مع إبقاء كل حالة وقت تشغيل مُنشأة ضمن نطاق واحد يديره المضيف.
يقع الموقع الافتراضي عمدًا خارج uploads، حيث قد تحظر المضيفات المحصّنة حمولات ذاكرة التخزين المؤقت لـPHP. غيّر الموقع باستخدام cache.path؛ تُحل المسارات النسبية انطلاقًا من WP_CONTENT_DIR، بينما تدعم المسارات المطلقة وحدات تخزين مؤقت مخصصة قابلة للكتابة:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
للإعدادات الخاصة بكل بيئة، استخدم مرشح الإعداد أو مرشح الدليل المحسوم:
add_filter('blockstudio/settings/cache/path', function () {
return '/srv/wordpress-cache/blockstudio';
});
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
يبدأ تغيير المسار بذاكرة تخزين مؤقت باردة. لن تعود الملفات القديمة ضمن wp-content/uploads/blockstudio/cache تُقرأ، ويمكن حذفها.
الهوية والإبطال
يُدرج كل نطاق ضمن هوية الشبكة/المدونة وهوية وقت تشغيل كاملة. وتتغير مدخلات ذاكرة التخزين المؤقت عند تغير المدخلات، بما فيها ملفات الكتل الخاضعة للمراقبة، وملفات الحقول، وتبعيات الأصول، والإعدادات، والقالب النشط، والإضافات النشطة، ومخزونات الاكتشاف المنطقي، وإصدارات WordPress وPHP وBlockstudio. وتعزل تجزئات التبعيات الخاصة بكل عنصر عمليات البناء التي تقتصر على العناصر المتغيرة عن الكائنات غير المرتبطة بها.
تضيف مصادر الاكتشاف المنطقي أيضًا معرّف المصدر وبصمة المحتوى ومدخلات المراقبة. ويمكن للاختيارات البديلة لوقت التشغيل إضافة قيمة blockstudio/cache/context لعزل جميع نطاقات التخزين المؤقت.
يمكن للمضيفات التي يختلف فيها حد المستأجر عن معرّفات الشبكة/المدونة WordPress تصفية blockstudio/cache/site_key؛ وتُنقّى النتيجة قبل استخدامها كمقطع في المسار.
في طلب واجهة أمامية دافئ، يهيئ Blockstudio سجل وقت التشغيل قبل إنشاء مصادر الاكتشاف. لذلك، تتجاوز إصابة ذاكرة التخزين المؤقت الصالحة اكتشاف المصادر تكراريًا، وإنشاء الكتل، وتحليل الحقول، واجتياز أشجار مفاتيح التخزين المؤقت المتكرر.
تخزّن حمولة وقت التشغيل أيضًا مسارات أصول الكتل التي تم حلها، وأحجامها وطوابعها الزمنية، وقوائم أوراق أنماط الوحدات. تعيد الطلبات الدافئة استخدام هذه البيانات الوصفية بدلًا من تكرار عمليات البحث عن مخرجات الأصول وفحص أدلة الوحدات لكل كتلة معروضة. تظل فلاتر أصول URL والتعطيل سارية للطلب الحالي، ويحافظ assets.inlineLimit على ميزانيته على مستوى الصفحة وترتيب التتابع. لا تُجمع بيانات وصفية لمخرجات الأصول عند تعطيل assets.enqueue أو التخزين المؤقت الدائم. ويلجأ البناء الأخير السليم القديم إلى حل أصوله من القرص.
تُعاد الاستفادة من بصمة الإعدادات التي لم تتغير داخل الطلب نفسه. يؤدي إعادة التحميل أو تغيير الإعدادات إلى إبطالها؛ وتُعاد تجزئة قيم الكائنات أو المراجع القابلة للتغيير بدلًا من إعادة استخدام بصمة قديمة.
في بيئتي production وstaging، يُوثق بلقطة مراقبة صالحة لمدة 20 ثانية قبل أن يعاود Blockstudio إحصاء ملفاته وأدلته. وتكون القيمة الافتراضية في بيئتي local وdevelopment صفرًا، كي تظهر تعديلات المصادر فورًا. غيّر هذه المدة باستخدام:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
قد يؤخر إلغاء الارتداد اكتشاف تغييرات المصدر تلقائيًا مدة لا تتجاوز عدد الثواني المُعدّ. ويظل التحقق من الأصول المترجمة المطلوبة، والأصول الخام المخزنة مؤقتًا وغير الفارغة، وأوراق أنماط الوحدات قائمًا عند كل إصابة في ذاكرة التخزين المؤقت. يؤدي حذف أحدها إلى إبطال حمولة وقت التشغيل فورًا بدلًا من تقديم بيانات وصفية قديمة للأصول حتى انتهاء المهلة. اضبط إلغاء الارتداد على 0 عند استخدام بيئة شبيهة بالإنتاج أيضًا لتحرير الملفات بنشاط.
تُحمى حمولات ذاكرة التخزين المؤقت بملفات PHP. تستخدم الحمولات الصغيرة مصفوفات عادية عندما تكون ذاكرة OPcache المشتركة نشطة لدى العملية الكاتبة ولا يكون الوجهة مستثناة. عندئذ يمكن لـ OPcache إعادة استخدام المصفوفة المترجمة في عمليات التضمين اللاحقة؛ ويظل تعديل البيانات المُعادة خاضعًا لسلوك النسخ عند الكتابة المعتاد في PHP.
من دون OPcache بذاكرة مشتركة، تظل الحمولة بيانات متسلسلة مضغوطة. وينطبق ذلك أيضًا عندما تكون ذاكرة OPcache ممتلئة، أو يكون API الخاص بها غير متاح أو مقيّدًا، أو تستبعد قائمتها المحظورة أو opcache.max_file_size الملف. لا يختار OPcache الذي يستخدم ذاكرة التخزين المؤقت للملفات فقط تنسيق المصفوفة العادية. راجع إعدادات OPcache على مستوى المضيف لمعرفة عناصر التحكم هذه. PHP
يبلغ الحد الأقصى للتنسيق الافتراضي للمصفوفة العادية 1 MiB، ويُقاس ذلك على البيانات المتسلسلة ومصدر PHP المُنشأ معًا. تظل الحمولات الأكبر مضغوطة لتجنب تكاليف ترجمة المصفوفات الكبيرة عندما تقرأ عملية CLI بلا OPcache ذاكرة تخزين مؤقت جهزتها عوامل الويب.
ولا تزال الملفات العادية الصغيرة بحاجة إلى التحليل لدى مثل هذه القارئات، وقد تحتاج الملفات المكتوبة حديثًا إلى الترجمة أثناء opcache.file_update_protection.
يتجاوز المرشح blockstudio/cache/compress التنسيق لكل نطاق، مثلًا عندما تجهز WP-CLI ملفات ذاكرة التخزين المؤقت لعوامل الويب المفعّل فيها OPcache. ويؤدي إرجاع false أيضًا إلى تجاوز حد الحجم؛ فلا تفعل ذلك إلا إذا كانت كل قارئة قادرة على التعامل مع ملف PHP المُنشأ. إذا لم تكن zlib متاحة، تظل PHP العادية هي الخيار الاحتياطي.
التزامن والاحتفاظ
تستخدم مفاتيح التخزين المؤقت الباردة قفلًا للطلب الواحد. ينشئ طلب واحد الحمولة، بينما تنتظر الطلبات المتزامنة النتيجة المنشورة ذريًا بدلًا من تكرار عمل الاكتشاف أو التجميع نفسه. ويمنع النشر الذري الكائنات الجزئية. وعند فشل التحديث، يظل آخر كائن صالح محفوظ متاحًا، ويكون الفشل قابلًا للرصد، ويمكن للطلب التالي التعافي.
تحتفظ نطاقات وقت التشغيل افتراضيًا بـ20 حمولة منشورة. اضبط الحد لكل نطاق عندما ينشئ التكامل عمدًا سياقات تخزين مؤقت أكثر:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
لا يؤدي الاحتفاظ إلى إخلاء أي ملف تشير إليه خريطة التقديم المبكر المثبتة، كما يحدد المرشح blockstudio/cache/protected_paths مسارات إضافية يجب أن يتجنبها التنظيف.
تُجمع مساحات الأسماء غير المستخدمة تلقائيًا بدلًا من تراكمها عند كل تفعيل لإضافة أو تحديث PHP أو WordPress. وينبغي لمقطع النشر الذي كان يستخدم نمط glob لدليل Tailwind القديم أن يستدعي Blockstudio\Runtime_Cache::purge('tailwind') بدلًا من ذلك.
تُحال مساحة الاسم إلى التقاعد عند تغير هوية وقت التشغيل، مثلًا بعد تحديث نواة WordPress. وفي أول جولة تنظيف ترصد تقاعدها، تُكتب علامة .retired فيها، ثم تُجمع شجرتها بعد مرور cache.namespaceGrace ثانية (يوم واحد افتراضيًا). وإذا كُتبت الشجرة مجددًا خلال هذه المدة، تبدأ فترة السماح من جديد. ولا تُجمع مساحة الاسم الحالية لأي نطاق، ولا مساحة اسم ما زالت خريطة التقديم المبكر تقدم منها عنصرًا مُفعّلًا؛ وتبدأ فترة السماح للأخيرة عند نقل مدخلها إلى مكان آخر في التفعيل التالي. وتواصل الصفحات المخزنة خارج WordPress ربط أوراق الأنماط ذات التجزئة المحتوائية التي صُيّرت بها، لذا ينبغي للموقع الذي يقدم صفحات tailwind.output: "link" عبر CDN أو ذاكرة تخزين مؤقت طويلة للمتصفح أن يزيد فترة السماح لتساوي أطول مدة يمكن أن تظل فيها هذه النسخة متاحة:
{
"cache": {
"namespaceGrace": 777600
}
}
عندما يحتوي تثبيت تمت ترقيته على دليل cache/runtime المسطح السابق للإصدار 7.6، يعيد Blockstudio تسميته ذريًا لإخراجه من المسار النشط. ثم تزيل مهمة WP-Cron ما يصل إلى 500 مدخل في نظام الملفات بكل دورة. وهذا يزيل الحمولات القديمة وأشجار .build.lock من دون أن يحذف الطلب الذي اكتشف دليلًا كبيرًا محتوياته تكراريًا. ولا يعمل التنظيف إلا أثناء نشاط cache.enabled؛ غيّر حجم الدفعة باستخدام blockstudio/cache/legacy_cleanup_batch_size عندما تحتاج المضيفة إلى دفعات أصغر أو أكبر.
عطّل ذاكرات التخزين المؤقت الدائمة في blockstudio.json:
{
"cache": {
"enabled": false
}
}
أو عبر مرشح:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
ذاكرة التخزين المؤقت للتصيير داخل الذاكرة لكل طلب، والموضحة ضمن الأداء، منفصلة عمدًا، لكن عناصرها الدائمة تستخدم حد نظام الملفات نفسه.
معالجة تراكم الأقفال القديمة
تركت الإصدارات السابقة لـ7.6.14 ملف .build.lock واحدًا لكل تغيير في المحتوى، وقد يحتوي موقع نشط على مئات الآلاف منها. بعد الترقية، تزيلها WP-Cron تلقائيًا على دفعات محدودة. لتصفية التراكم فورًا ومعرفة عدد الملفات، شغّل CLI:
wp bs cache status
wp bs cache cleanup
يحصي status الأقفال القديمة المتبقية ويبلغك بموعد الدفعة التالية. ويشغّل cleanup دفعات متتالية حتى لا يبقى شيء غير نشط، ثم يجمع مساحات أسماء التخزين المؤقت التي انتهت فترة السماح فيها. تُترك الأقفال الأحدث من ساعة أو التي لا يزال طلب قيد التشغيل يمسك بها للجولة التالية. لا تحذف ملفات الأقفال يدويًا أبدًا أثناء استقبال الموقع للزيارات؛ فالقفل الممسوك هو آلية الانتخاب التي تمنع الطلبات المتزامنة من البناء بالتوازي.
يمسح wp bs cache clear ذاكرة تخزين وقت التشغيل المؤقتة بالكامل للموقع الحالي، أو نطاقًا واحدًا عبر جميع مساحات الأسماء باستخدام --scope=runtime. سيعيد الطلب التالي البناء من حالة باردة، لذا شغّله في وقت انخفاض الزيارات.
ذاكرة تخزين Tailwind المؤقتة
تستخدم ذاكرة Tailwind المؤقتة لـCSS المُجمّعَة جذر وقت التشغيل المشترك ضمن مساحة أسماء الشبكة/الموقع/وقت التشغيل، ونطاق tailwind. وتخزّن حتى 1,000 مدخل لمدة 30 يومًا افتراضيًا، ما يكفي للاحتفاظ بمفاتيح مستوى الصفحة لموقع كامل بدلًا من إخلائها بعد عدد قليل من المسارات.
تعيد Tailwind أيضًا استخدام مُجمّع دافئ للمدخل CSS نفسه داخل العمليات طويلة الأمد، وتحفظ حالة إنشاء المُجمّع بين العمليات. ولا تزال مجموعات الصفحات المرشحة الباردة تُجمّع بشكل مستقل، لكنها لا تحتاج إلى إعادة بناء محلل الإطار في كل مرة.
استخدم هذه المرشحات لتغيير مدة الاحتفاظ:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
الحد الأدنى للعمر ساعة واحدة.
تُجزّأ ملفات ذاكرة التخزين المؤقت بحسب المحتوى، وترتبط الصفحة المخزنة بواحد منها عبر URL، لذا قد يختلف الملف المُخلى والصفحة المخزنة بشأن الملفات التي لا تزال مهمة. ويُتحقق من المستندات المُسبقة التصيير مقابل ورقة الأنماط المرتبطة بها قبل تقديمها، لذا يؤدي إخلاء ملف إلى إعادة تصيير واحدة بدلًا من عرض الصفحة دون تنسيق. وتجنّب زيادة cache_max_files عن عدد المفاتيح المختلفة على مستوى الصفحات إعادة التصيير بالكامل.
ذاكرة التخزين المؤقت المجهولة HTML الموجودة تحت الجذر نفسه.