SDWSKi Cache. Плагін кэшавання для WordPress

Задача

Стандартныя кэш-плагіны добра працуюць у блогах і дрэнна — у крамах. Тыповыя праблемы, якія я хацеў вырашыць:

• у кэш трапляе старонка з чужым лічыльнікам кошыка;
• у картцы тавару застаецца стары астатак;
• шматмоўны сайт аддае наведвальніку старонку не на яго мове;
• пры збоі аптымізацыі (мініфікацыя, аб’яднанне файлаў) карыстальнік бачыць пусты экран;
• у адмінцы поўна рэкламы і спасылак на старонні сайт.

Архітэктура

Плагін складаецца з трох узроўняў, кожны з якіх вырашае сваю частку задачы.

1. Загрузчык (sdwski-cache.php). Вырашае толькі адно: ці можна запускаць рухавік. Калі на сайце ўжо актыўны арыгінальны плагін або іншая копія, загрузчык нічога не падключае, не рэгіструе хукі і паказвае апавяшчэнне з кнопкай «Адключыць і запусціць». Усе класы, функцыі і канстанты рухавіка маюць уласныя прэфіксы, таму памылкі кшталту «Cannot redeclare» выключаны, у якім бы парадку WordPress ні загрузіў плагіны.

2. Рухавік (sdwski-engine.php, inc/). Класічны ўзровень: генерацыя і ачыстка кэша, мініфікацыя і аб'яднанне CSS/JS, папярэдняя загрузка, правілы выключэнняў, CDN (у тым ліку Cloudflare), ачыстка Varnish, модуль бяспекі, планіроўшчык ачысткі, WP-CLI. Тут жа перахопліваецца вывад старонкі праз output buffer.

3. Turbo-ўзровень (inc/turbo/). Мой асноўны ўнёсак. Гэта drop-in advanced-cache.php, які WordPress падключае раней за тэму і плагіны, і ядро turbo-core.php, якое кіруе яго наладамі, статусам і ачысткай.

Як працуе аддача з drop-in

Парадак праверак у advanced-cache.php выбудаваны так, каб пры любым сумненні перадаць запыт WordPress:

1. Апрацоўваюцца толькі запыты GET.
2. Запыты бота папярэдняй загрузкі заўсёды накіроўваюцца ў WordPress, каб старонка была створана або абноўлена.
3. Хост і схема (http/https) павінны супадаць з адрасам сайта, што ахоплівае варыянты з www і без яго.
4. Калі ў cookie ёсць прыкметы карыстальніка, які ўвайшоў у сістэму, каментатара, абароненага паролем запісу або сесіі крамы, наведвальнік атрымлівае жывую старонку. Спіс можна пашырыць уласнымі назвамі cookie.
5. Толькі пасля гэтага ў кэшы шукаецца гатовы файл.

Калі файл знойдзены, адказ фарміруецца без запуску WordPress. У загалоўках перадаюцца Vary: Accept-Encoding, ETag і X-ruzi-Turbo: HIT, які зручна правяраць у браўзеры або праз curl -I.

Папярэдне сціснутыя копіі і ўмоўныя запыты

Сцісканне выконваецца адзін раз пры стварэнні старонкі, а не пры кожным запыце. Побач з index.html ляжаць index.html.gz і, калі на серверы ёсць пашырэнне brotli, index.html.br. Drop-in правярае загаловак Accept-Encoding і вяртае адпаведны варыянт. На ўмоўны запыт з супалым ETag адказвае 304 без чытання файла.

Пры ачыстцы кэша выдаляюцца ўсе варыянты старонкі: звычайны, gzip і brotli, а таксама пастаронкавая навігацыя і копіі паводле моў. Гэта абараняе ад «асірацелых» сціснутых файлаў, якія інакш перажылі б выдаленую старонку.

Рэжым інтэрнэт-крамы (WooCommerce)

Самая аб'ёмная частка працы. Правілы дублююцца на трох узроўнях: у .htaccess, у drop-in і ў рухавіку, таму абарона не залежыць ад аднаго пераключальніка.

Усе налады крамы вынесены на асобную ўкладку «WooCommerce». Класы элементаў можна ўводзіць без кропкі, напрыклад cart-count.

Многоязычность

Кэш вядзецца асобна для кожнай мовы, таму наведвальнік з англійскай версіяй не атрымае кэш рускай і наадварот. Плагін SDWSKi Cache сумяшчальны з плагінамі шматмоўнасці. У першую чаргу 100% гарантаваная сумяшчальнасць з плагінам ШІ-перакладу SDWSKi Перакласці.

Адмоваўстойлівасць

• Адкат пры збоі аптымізацыі. Буфер вываду зваротнага выкліку абаронены: калі мініфікацыя або аб'яднанне файлаў завяршыліся памылкай, вяртаецца зыходная старонка.
• Drop-in можна выдаліць у любы момант. Тады WordPress проста працягвае працаваць як звычайна, пра гэта сказана ў самім загалоўку файла.
• Старонка стану Turbo паказвае па пунктах, ці ўсё наладжана: drop-in, правы, .htaccess, даступнасць brotli.
• Бяспечнае выдаленне. Плагін не выдаляе агульныя даныя, пакуль на сайце застаецца іншая копія рухавічка.

Што яшчэ ёсць унутры

Папярэдняя загрузка кэша паводле раскладу праз WP-Cron, мініфікацыя HTML/CSS/JS, аб’яднанне файлаў, адкладзеная загрузка выяў, правілы выключэнняў, ачыстка кэша пэўных старонак, налады для Nginx і Varnish, інтэграцыі з CDN, кэшаванне ў браўзеры, адключэнне emoji, WP-CLI. Інтэрфейс і падрабязная ўкладка «Інструкцыя» перакладзены на рускую мову.

Стэк

PHP, WordPress Plugin API (хукі, WP-Cron, output buffering, drop-in advanced-cache.php), правілы Apache .htaccess, JavaScript і CSS для інтэрфейсу адміністратара і «жывых» элементаў крамы, gettext (.pot, .po, .mo) для лакалізацыі.

Усталяванне

1. Скапіруйце папку sdwski-cache ў /wp-content/plugins/ і актывуйце плагін.
2. У меню «SDWSKi Cache» уключыце «Cache System» і захавайце.
3. Адкрыйце «Налады → SDWSKi Cache: Turbo» і пераканайцеся, што ўсе пункты стану зялёныя.
4. Праверце вынік: адкрыйце старонку ў прыватным акне і знайдзіце загаловак X-ruzi-Turbo: HIT.

История версий

• 1.5.3-turbo.10 — асобная ўкладка WooCommerce, «жывыя» рэшткі, «жывы» міні-кошык.
• 1.5.3-turbo.9 — абарона кошыка і рэшткаў цяпер заўсёды ўключана пры актыўным WooCommerce, ачыстка кэша пры любых зменах тавару і заказу, максімальны тэрмін захоўвання кэша — 3 гадзіны.
• 1.5.3-turbo.8 — лічыльнік кошыка падстаўляецца скрыптам, выпраўлена захаванне налад рэжыму крамы.
• 1.5.3-turbo.2 — абарона ад канфлікту з арыгінальным плагінам, уласная папка, укладка «Інструкцыя».
• 1.5.3-turbo.1 — рэжым крамы, drop-in, папярэдне сціснутыя старонкі, ETag і 304, новы інтэрфейс, рэклама выдалена.

Ліцэнзія і паходжанне

Праект распаўсюджваецца паводле GPLv2 або навейшай версіі. Ён заснаваны на адкрытай GPL-убудове кэшавання старонак: зыходны код належыць яго аўтарам, а мае змены і дапаўненні аформлены асобна і апісаны вышэй.