Caching
Blockstudio menyertakan cache persisten berbasis file. Cache ini diaktifkan secara default melalui pengaturan cache.enabled dan ditulis ke:
wp-content/blockstudio/cache/
Akar terkonfigurasi ini menampung payload build runtime, data pendaftaran blok yang telah dibangun sebelumnya, aset editor, Tailwind CSS, dokumen yang dirender, fragmen island, HTML statis, indeks graf, antrean hangat, dan diagnostik cache. Ini menghindari pengulangan pekerjaan penemuan, penguraian, kompilasi, dan perenderan, sekaligus menjaga semua status runtime yang dihasilkan dalam satu batas yang dapat dikelola host.
Default sengaja ditempatkan di luar uploads, tempat host yang diperketat keamanannya mungkin memblokir payload cache PHP. Ubah lokasinya dengan cache.path; jalur relatif dihitung dari WP_CONTENT_DIR, sedangkan jalur absolut mendukung volume cache khusus yang dapat ditulisi:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Untuk konfigurasi khusus lingkungan, gunakan filter pengaturan atau filter direktori yang telah ditentukan:
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';
});
Mengubah jalur akan memulai cache yang masih kosong. File lama di bawah wp-content/uploads/blockstudio/cache tidak lagi dibaca dan dapat dihapus.
Identitas dan invalidasi
Setiap cakupan berada di dalam identitas jaringan/blog dan identitas runtime lengkap. Entri cache berubah saat inputnya berubah, termasuk file blok yang dipantau, file field, dependensi aset, pengaturan, tema aktif, plugin aktif, inventaris penemuan logis, versi WordPress, PHP, dan Blockstudio. Hash dependensi khusus item mengisolasi build yang hanya memperbarui item berubah dari objek yang tidak terkait.
Sumber penemuan logis juga menyumbangkan ID sumber, sidik jari konten, dan input pemantauannya. Pilihan runtime alternatif dapat menambahkan nilai blockstudio/cache/context untuk mengisolasi semua cakupan cache.
Host yang batas tenantnya berbeda dari ID jaringan/blog WordPress dapat memfilter blockstudio/cache/site_key; hasilnya disanitasi sebelum menjadi segmen jalur.
Pada permintaan frontend yang menggunakan cache hangat, Blockstudio memuat registry runtime sebelum membangun sumber penemuan. Karena itu, cache yang valid melewati penemuan sumber rekursif, konstruksi blok, penguraian field, dan penelusuran ulang pohon kunci cache.
Payload runtime juga menyimpan path aset blok yang sudah di-resolve, ukuran, stempel waktu, dan daftar stylesheet modul. Permintaan hangat menggunakan kembali metadata tersebut, alih-alih mengulangi pencarian keluaran aset dan pemindaian direktori modul untuk setiap blok yang dirender. URL aset dan filter penonaktifan tetap berjalan untuk permintaan saat ini, dan assets.inlineLimit mempertahankan anggaran seluruh halaman serta urutan kaskadenya. Metadata keluaran aset tidak dikumpulkan jika assets.enqueue atau caching persisten dinonaktifkan. Build terakhir yang baik tetapi sudah usang akan mengatasi asetnya dengan mengambilnya dari disk.
Pengaturan terselesaikan yang tidak berubah juga menggunakan kembali sidik jarinya dalam permintaan. Memuat ulang atau mengubah pengaturan akan membatalkannya; nilai objek atau referensi yang dapat diubah akan di-hash ulang, bukan menggunakan kembali sidik jari yang mungkin sudah usang.
Di production dan staging, snapshot pemantauan yang divalidasi dipercaya selama 20 detik sebelum Blockstudio memeriksa kembali statistik file dan direktorinya. Lingkungan local dan development secara default menggunakan nol agar perubahan sumber langsung terlihat. Ubah interval tersebut dengan:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Debounce dapat menunda deteksi perubahan sumber otomatis paling lama selama jumlah detik yang dikonfigurasi. Aset terkompilasi yang diperlukan, aset mentah nonkosong yang di-cache, dan stylesheet modul tetap diperiksa setiap kali cache digunakan. Menghapus salah satunya akan langsung membatalkan payload runtime, alih-alih menyajikan metadata aset usang hingga periode tersebut berakhir. Atur debounce ke 0 jika lingkungan yang menyerupai produksi juga digunakan untuk penulisan file secara aktif.
Payload cache dilindungi sebagai file PHP. Payload kecil menggunakan array biasa jika proses penulisan memiliki memori bersama OPcache yang aktif dan tujuan tidak dikecualikan. Dengan begitu, OPcache dapat menggunakan kembali array terkompilasi pada penyertaan berikutnya; perubahan pada data yang dikembalikan tetap mengikuti perilaku copy-on-write normal milik PHP.
Tanpa OPcache dengan memori bersama, payload tetap berupa data serialisasi terkompresi. Ini juga berlaku jika OPcache penuh, API tidak tersedia atau dibatasi, atau daftar hitam maupun opcache.max_file_size mengecualikan file tersebut. OPcache yang hanya menggunakan cache file tidak memilih format array biasa. Lihat konfigurasi OPcache PHP untuk kontrol tingkat host tersebut.
Format array biasa bawaan dibatasi hingga 1 MiB, diukur berdasarkan data serialisasi dan sumber PHP yang dihasilkan. Payload yang lebih besar tetap dikompresi untuk menghindari biaya kompilasi array besar ketika proses CLI tanpa OPcache membaca cache yang telah dihangatkan oleh worker web.
File biasa yang kecil tetap perlu diuraikan oleh pembaca seperti itu, dan file yang baru ditulis mungkin perlu dikompilasi selama opcache.file_update_protection.
Filter blockstudio/cache/compress mengganti format untuk tiap cakupan, misalnya saat WP-CLI menghangatkan file cache untuk worker web yang mengaktifkan OPcache. Mengembalikan false juga mengesampingkan batas ukuran: lakukan ini hanya jika setiap pembaca dapat menangani file PHP yang dihasilkan. Jika zlib tidak tersedia, PHP biasa tetap menjadi pilihan cadangan.
Konkurensi dan retensi
Kunci cache dingin menggunakan lock single-flight. Satu permintaan membangun payload sementara permintaan serentak menunggu hasil yang dipublikasikan secara atomik, alih-alih mengulangi pekerjaan penemuan atau kompilasi yang sama. Publikasi atomik mencegah objek parsial. Jika penyegaran gagal, objek valid terakhir yang berhasil tetap tersedia, kegagalannya dapat diamati, dan permintaan berikutnya dapat memulihkan keadaan.
Cakupan runtime secara default mempertahankan 20 payload yang telah dipublikasikan. Sesuaikan batas per cakupan jika integrasi sengaja membuat lebih banyak konteks cache:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
Retensi tidak pernah menghapus file yang dirujuk oleh peta penyajian awal yang terpasang, dan filter blockstudio/cache/protected_paths menandai jalur tambahan yang harus dilewati saat pemangkasan.
Namespace yang tidak digunakan dikumpulkan secara otomatis, bukan terus menumpuk setiap kali plugin diaktifkan dan PHP atau WordPress diperbarui. Cuplikan penerapan yang sebelumnya menggunakan glob pada direktori cache Tailwind lama sebaiknya memanggil Blockstudio\Runtime_Cache::purge('tailwind').
Namespace dihentikan saat identitas runtime berubah, misalnya setelah pembaruan inti WordPress. Proses pembersihan pertama yang menemukannya telah dihentikan akan menulis penanda .retired ke dalamnya, dan pohon tersebut dikumpulkan setelah cache.namespaceGrace detik berlalu sejak saat itu (secara default satu hari). Pohon yang ditulis ulang selama waktu tersebut memulai kembali masa tenggangnya. Namespace saat ini dari suatu cakupan maupun namespace yang masih menyajikan artefak teraktivasi melalui peta penyajian awal tidak akan dikumpulkan; masa tenggang namespace terakhir dimulai setelah aktivasi berikutnya memindahkan entri petanya. Halaman yang di-cache di luar WordPress tetap menautkan stylesheet dengan hash konten yang digunakan saat halaman dirender, sehingga situs yang menyajikan halaman tailwind.output: "link" melalui CDN atau cache browser berdurasi panjang sebaiknya memperpanjang masa tenggang hingga setidaknya selama salinan tersebut dapat bertahan:
{
"cache": {
"namespaceGrace": 777600
}
}
Saat instalasi yang dimutakhirkan berisi direktori cache/runtime datar pra-7.6, Blockstudio akan mengganti namanya secara atomik agar keluar dari jalur aktif. Tugas WP-Cron kemudian menghapus maksimal 500 entri sistem file per proses. Ini mencegah payload dan pohon .build.lock lama menghabiskan ruang disk tanpa membuat permintaan yang mendeteksi direktori besar menghapusnya secara rekursif. Pembersihan hanya berjalan saat cache.enabled aktif; ubah ukuran kelompoknya dengan blockstudio/cache/legacy_cleanup_batch_size jika host memerlukan proses yang lebih kecil atau lebih besar.
Nonaktifkan cache persisten di blockstudio.json:
{
"cache": {
"enabled": false
}
}
Atau melalui filter:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
Cache render dalam memori per permintaan yang dijelaskan di bagian Performa memang terpisah, tetapi artefak persisten cache tersebut menggunakan batas sistem file yang sama.
Mengosongkan antrean lock lama
Rilis sebelum 7.6.14 meninggalkan satu file .build.lock untuk setiap perubahan konten, dan situs yang sibuk dapat memiliki ratusan ribu file semacam itu. Setelah pemutakhiran, WP-Cron akan menghapusnya sendiri dalam kelompok yang dibatasi. Untuk langsung mengosongkan antrean dan memberikan jumlahnya kepada host, jalankan CLI:
wp bs cache status
wp bs cache cleanup
status menghitung jumlah lock lama yang tersisa dan melaporkan waktu kelompok berikutnya dijalankan. cleanup menjalankan kelompok-kelompok hingga tidak ada lagi yang menganggur, lalu mengumpulkan namespace cache yang masa tenggangnya telah lewat. Lock yang berusia kurang dari satu jam atau masih dipegang oleh permintaan yang berjalan akan dibiarkan untuk proses berikutnya. Jangan pernah menghapus file lock secara manual saat situs melayani lalu lintas; lock yang sedang dipegang adalah mekanisme pemilihan yang mencegah permintaan serentak membangun secara paralel.
wp bs cache clear menghapus seluruh cache runtime untuk situs saat ini, atau satu cakupan di semua namespace dengan --scope=runtime. Permintaan berikutnya akan membangun ulang dari awal, jadi jalankan saat lalu lintas rendah.
Cache Tailwind
Cache CSS terkompilasi milik Tailwind menggunakan akar runtime bersama di bawah namespace jaringan/situs/runtime dan cakupan tailwind. Secara default, cache ini menyimpan hingga 1,000 entri selama 30 hari, cukup untuk mempertahankan kunci tingkat halaman bagi seluruh situs, alih-alih menghapusnya setelah sejumlah kecil rute.
Tailwind juga menggunakan ulang kompilator hangat untuk input CSS yang sama di dalam proses berumur panjang dan menyimpan status konstruksi kompilator di antara proses. Kumpulan kandidat halaman dingin tetap dikompilasi secara terpisah, tetapi parser framework tidak perlu dibangun ulang setiap kali.
Gunakan filter ini untuk mengubah retensi:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
Usia minimum adalah satu jam.
File cache menggunakan hash konten, dan halaman yang di-cache menautkan satu file melalui URL, sehingga penghapusan cache dan halaman yang disimpan dapat berbeda pendapat tentang file mana yang masih diperlukan. Dokumen yang dirender sebelumnya diperiksa terhadap stylesheet tertautnya sebelum disajikan, sehingga file yang terhapus menyebabkan satu kali perenderan ulang, bukan halaman tanpa gaya. Menaikkan cache_max_files melebihi jumlah kunci tingkat halaman yang berbeda akan menghindari perenderan ulang sepenuhnya.
Cache HTML anonim yang berada di bawah akar yang sama.