Description
LumenCache implements a RAM-first full-page cache with a WordPress
advanced-cache.php drop-in. On a cache HIT, the drop-in serves complete HTML
before the normal WordPress bootstrap and database queries. This early-response
path reduces application-layer work and keeps repeat page requests fast across
Nginx, Apache, and LiteSpeed.
The cache is designed to fail open when its storage layer is unavailable, so a
cache connection problem does not take the WordPress site offline.
Research Foundation
Academic Reference:
“Dynamic Resource Mapping in Zero-Reload Server Architectures: Eliminating
Application-Layer Latency and Extension Dependency in High-Concurrency CMS
personalised requests continue through the full WordPress stack.
This architecture is intended to reduce repeated bootstrap work, database
queries, and extension overhead while preserving WordPress compatibility. It
also provides a practical bridge between academic performance research and
everyday publishing workloads, including content-heavy sites, WooCommerce
catalogues, and membership-driven pages.
Research author: Professor Nasrul Eam — Dean, Light & Composition University.
Ten-Subsystem Architecture
- RAM-First Full-Page Cache Engine — PHP stores complete HTML at
shutdown and resolves repeat requests from the in-memory cache layer. - Nginx / Apache Proxy Bridge — Static or dynamic server config bypasses
PHP entirely for cache hits. - Selective Bypass Cookie Router —
sys_active_statecookie routes
logged-in users and cart-active visitors to live PHP. - Application Driver Profile Engine — Auto-detects WooCommerce,
LearnDash, LifterLMS, MemberPress, BuddyBoss and registers tailored bypass
rules and invalidation hooks. - Surgical Cache Invalidation — Post save / nav menu / widget / theme
switch events trigger precise per-URL or full purges. - REST API State Endpoint —
/wp-json/lumencache/v1/user-stateserves
personalised fragments for skeleton-hydration clients. - Skeleton Hydration DOM Worker —
skeleton-hydration.jsreplaces cached
placeholders with live content on load. - WP-CLI Management Interface —
flush,flush-url,statuscommands.
Architectural Resilience Against Runtime Exploits (Case Study: php2shell / CVE-2026-109618 & CVE-2026-109619)
The recent critical vulnerabilities (such as the October 2026 php2shell flaws, CVE-2026-109618 and CVE-2026-109619) exploit internal memory management, request lifecycles, and Out-Of-Memory (OOM) error handling inside the C-level PHP engine itself. Whenever runtime vulnerabilities emerge, automated exploit scanners flood millions of WordPress websites searching for unauthenticated vulnerable endpoints.
LumenCache provides immediate defense-in-depth mitigation through its zero-worker server proxy architecture:
- Bypassing PHP Completely (Nginx / Apache / LiteSpeed Proxy Mode): When server-level proxy rules are enabled (Nginx FastCGI cache,
redis_pass, or LiteSpeed.htaccessdirect RAM rewrites), cache HIT requests never touch PHP-FPM or the PHP interpreter at all. - Automated Exploit & Scanner Deflection: Malicious crawlers or automated exploit scanners scanning public cached URLs are intercepted at the web server layer and served raw static HTML directly from RAM. Because PHP is never invoked, the vulnerability cannot be triggered on those requests.
- Worker & Memory Starvation Defense: Protects against Out-Of-Memory (OOM) denial-of-service by keeping PHP-FPM worker pools 100% isolated for authentic logged-in users and checkout actions.
(Note: A caching plugin does not replace updating your server binaries; hosting administrators must still update PHP to patched point releases. LumenCache acts as an architectural first-line attack surface reducer).
Configuration (optional)
All settings are configurable from LumenCache → Settings in the WordPress
admin. Optionally override any setting via wp-config.php — constants always win:
define( 'LUMENCACHE_REDIS_HOST', '127.0.0.1' );
define( 'LUMENCACHE_REDIS_PORT', 6379 );
define( 'LUMENCACHE_REDIS_SOCKET', '' );
define( 'LUMENCACHE_REDIS_PASSWORD', '' );
define( 'LUMENCACHE_REDIS_DATABASE', 0 );
define( 'LUMENCACHE_REDIS_TIMEOUT', 1.0 );
define( 'LUMENCACHE_REDIS_PREFIX', 'cache:' );
define( 'LUMENCACHE_CACHE_TTL', 86400 );
define( 'LUMENCACHE_CACHE_SALT', '' );
define( 'LUMENCACHE_CACHE_QUERY_STRINGS', false );
define( 'LUMENCACHE_PROXY_PASSWORD', '' );
WP-CLI
wp lumencache flush
wp lumencache flush-url https://example.com/page/
wp lumencache status<h3>Privacy</h3>
LumenCache stores rendered page HTML and cache metadata in the in-memory cache
service configured by the site administrator. It does not send cache contents,
visitor data, or analytics data to a third-party LumenCache service. The
optional user-state endpoint returns only the requested dynamic values to the
requesting browser; sites should review those values and their own privacy
policy before enabling personalized hydration.
FAQ
How does LumenCache mitigate exposure to the recent critical vulnerabilities (such as the October 2026 php2shell flaws, CVE-2026-109618 and CVE-2026-109619)?
The recent critical vulnerabilities (such as the October 2026 php2shell flaws, CVE-2026-109618 and CVE-2026-109619) exploit internal C-level PHP engine memory lifecycles via HTTP request floods.
While LumenCache is a caching engine and cannot patch the underlying PHP binary (which your hosting provider or sysadmin must update to patched point releases), LumenCache provides an immediate Attack Surface Reducer:
- Never Spawns PHP on Cache Hits: In server proxy mode, Nginx, Apache, or LiteSpeed serves cached pages directly from Redis/RAM in <1ms without starting a PHP worker or invoking the PHP interpreter.
- Deflects Automated Exploit Probing: Exploit scanners scanning your public pages hit static RAM storage, preventing malicious payloads from reaching PHP memory or triggering OOM crashes.
- Eliminates Worker Pool Starvation: Keeps your site fast and accessible during vulnerability disclosure waves by preventing botnet floods from exhausting PHP-FPM processes.
Getting a 502 Bad Gateway on Nginx after activating or during WooCommerce use?
Nginx has a default fastcgi_buffer_size of only 4KB–8KB. When combining rich caching headers with WooCommerce session cookies, the upstream response header exceeds this limit. Nginx immediately terminates the connection with:
upstream sent too big header while reading response header from upstream, resulting in an instant 502 Bad Gateway error.
To resolve this, add the following FastCGI and proxy buffer directives to your Nginx configuration (within the http {}, server {}, or PHP location block):
fastcgi_buffer_size 32k;
fastcgi_buffers 16 16k;
fastcgi_busy_buffers_size 32k;
proxy_buffer_size 32k;
proxy_buffers 16 16k;
proxy_busy_buffers_size 32k;
After adding these directives, test and reload Nginx:
nginx -t && systemctl reload nginx
Why are 0 pages cached?
Two common causes:
1. Nginx config not applied — visit Server Setup and paste the config blocks.
2. WooCommerce session cookie — fixed in v1.1.0. Previous versions bypassed
the cache for all visitors on WooCommerce sites due to the always-present
wp_woocommerce_session_* cookie.
Why can key salting affect server-level caching?
When LUMENCACHE_CACHE_SALT is set, PHP stores keys as SHA-256 hashes. A
server-level configuration must use the same key strategy or it will produce
cache misses. Disable the salt for a plain-key configuration, or use the
compatible hashed-key server template.
Does LumenCache work with LiteSpeed?
Yes. LiteSpeed supports Apache-compatible .htaccess rewrites. LumenCache uses
the Apache proxy mode on LiteSpeed. For better performance, ask your host
which in-memory cache acceleration options are available.
Can I still use wp-config.php constants?
Yes — constants always take precedence over admin settings. If you define a
constant, the corresponding field in the Settings tab is shown locked (read-only).
Changelog
1.8.14 (November 1, 2026)
- PRE-BOOTSTRAP LMS & COMMUNITY COOKIE PARITY: Integrated Tutor LMS (
tutor_*), Sensei LMS (sensei_*), and BuddyPress/BuddyBoss (bp-*,bb_*) cookie bypass detection intoadvanced-cache.php. Guarantees active students and community members bypass the full-page cache in sub-millisecond time before WordPress loads. - VENDOR-NEUTRAL INTAKE PORTAL & SUBMISSION ROUTE DECOUPLING: Decoupled custom intake wizards, application portals, and submission endpoints into extensible compiled bypass patterns and generic route guards, maintaining strict public repository compliance.
- EXTENSIBLE DROP-IN COMPILER HOOKS: Introduced the
lumencache_dropin_compiled_bypass_patternsfilter inDrop_In::write_config(), enabling application framework drivers and custom plugins to inject pre-bootstrap URL bypass regexes into compiled snapshot configurations automatically. - PROXY EXECUTION ORDER & CONFIGURATION HARMONIZATION: Restructured configuration and constant declaration in
server/lumen-cache-proxy.phpto guarantee compiled settings snapshots are fully defined before early bypass evaluations execute. - AUTOMATED DROP-IN UPGRADE & VERSION SYNCHRONIZATION: Added automated drop-in deployment and version tracking hooks for administrative and WP-CLI lifecycles (
admin_init), ensuringwp-content/advanced-cache.phpstays strictly in sync with plugin releases without manual reactivation. Gated behind admin/CLI contexts for 100% zero-write visitor GET compliance.
1.8.13 (November 1, 2026)
- REST API USER-STATE SECURITY HARDENING: Added
X-Content-Type-Options: nosniffheader protection to/wp-json/lumencache/v1/user-statealongside strictno-store, no-cache, must-revalidatedirectives, preventing MIME sniffing attacks during dynamic DOM hydration. - EXTENDED LMS SKELETON HYDRATION: Added Tutor LMS completion percentage resolution to
course-progressREST state, allowing course progress bars and learner widgets to hydrate accurately on cached course pages. - AUTOMATED HYDRATION SCRIPT SENSING: Enhanced
REST_API::enqueue_hydration_script()to auto-detect Tutor LMS and Sensei LMS constants and dynamically enqueue frontend skeleton hydration scripts only when relevant e-learning platforms are active. - WP-CLI SOVEREIGN PROXY COMMAND SUITE: Introduced
wp lumencache deploy-proxysubcommand, providing headless automation and DevOps pipelines with one-command deployment oflumen-cache-proxy.phptowp-content/uploads/.
1.8.12 (November 1, 2026)
- NATIVE TUTOR LMS & SENSEI LMS INTEGRATION: Integrated dedicated auto-detection drivers for modern e-learning ecosystems (Tutor LMS and Sensei LMS). Automatically establishes sub-millisecond bypass rules for dynamic student dashboard and quiz routes (
/courses/,/lessons/,/quizzes/,/tutor-dashboard/,/my-courses/) and cookie sessions (tutor_*,sensei_*), while binding course progression and completion hooks to instant cache invalidation. - REAL-TIME E-COMMERCE PRODUCT REVIEW INVALIDATION: Connected WooCommerce customer review lifecycles (
comment_post,wp_set_comment_status,trash_comment,untrash_comment,deleted_comment) to parent product cache invalidation. Ensures customer review approvals, star ratings, and review counter increments immediately reflect on cached product pages. - EXTENSIBLE COMMERCE PRODUCT PURGE ACTIONS: Decoupled custom and third-party e-commerce product type purge routines via new action hook
lumencache_purge_woocommerce_product, enabling specialized booking portals, catalog galleries, and digital course products to flush related overview hubs without hardcoded internal dependencies. - SITE-WIDE NAVIGATION MENU & SIDEBAR WIDGET CACHE FLUSHING: Hooked core WordPress menu modifications (
wp_update_nav_menu,wp_delete_nav_menu) and sidebar widget layout changes (update_option_sidebars_widgets) to automatic cache invalidation, guaranteeing header navigation and widget updates reflect instantly across all cached pages.
1.8.11 (November 1, 2026)
- SPECULATION RULES SCHEMA CONFORMANCE & TARGET HINT: Aligned W3C Speculation Rules document rule generation with current browser standards, enforcing
target_hint: "_self"for prerender rules to prevent failed prerenders on new-tab navigations (target="_blank"). - MOBILE SAVE-DATA BANDWIDTH RESPECT: Integrated client-side data saving detection (
Save-Data: on) intoSpeculation_Rules::should_render(), automatically suppressing speculative prerendering and prefetching on cellular connections when data conservation is requested. - VENDOR-NEUTRAL EXCLUDED SELECTOR & HREF ENGINE: Decoupled speculative loading exclusions into generalized, robust patterns matching standard commerce buttons (
a.button[class*="product_type_"],[class*="add-to-cart"],[class*="booking-btn"],button[name*="add-to-cart"]), external tabs (a[target="_blank"]), downloads (a[download]), and untrusted relationships (a[rel~="nofollow"]). - EXTENDED AUTHENTICATION & TOKEN ROUTE EXCLUSIONS: Expanded excluded URL patterns to safeguard account recovery, one-time authentication tokens, registration flows, and LMS completion endpoints (
*wp-signup*,*wp-activate*,*lost-password*,*resetpass*,*customer-logout*,*order-tracking*,*course-progress*,*course-complete*). - CONTENT SECURITY POLICY (CSP) SCRIPT NONCE SUPPORT: Added
lumencache_speculation_rules_noncefilter hook to allow security plugins and themes to inject dynamic CSP script nonces into<script type="speculationrules">output. - REST API SECURITY HEADERS & PERMALINK TOLERANCE: Added
X-Content-Type-Options: nosniffheader protection to/wp-json/lumencache/v1/speculation-rulesand preserved query strings inSpeculation-RulesHTTP response headers for non-pretty permalink setups.
1.8.10 (November 1, 2026)
- NATIVE AVIF, WEBP & WASM STATIC LAYER INTEGRATION: Expanded static asset rules and location directives across the Nginx server block generator, global server template, per-site example, and Apache/LiteSpeed
.htaccessrules to explicitly recognize modern image formats (.webp,.avif) and WebAssembly modules (.wasm). Guarantees next-gen media assets are served directly from disk with immutable caching headers (Cache-Control: public, immutable; expires max;) rather than incorrectly falling through to page caching or dynamic backend workers. - EDGE SESSION COOKIE PARITY ACROSS WEB SERVERS: Synchronized Nginx
mapdirectives, Apache rewrite conditions, and the standalone proxy runner to evaluate extended e-learning and community authentication cookies (tutor_*,sensei_*,bp-*,bb_*) alongside existing commerce and membership session keys, guaranteeing instant live routing for active learners across all edge server layers. - ZERO-WRITE NGINX TELEMETRY GATING: Hardened
Server_Config::nginx_config_active()to strictly gate transient persistence to administrative and background worker contexts, eliminating unintended database write operations during public visitor GET requests. - SOVEREIGN REWRITE PROXY DEPLOYMENT & 1-CLICK CONTROLS: Upgraded
Htaccess::deploy_proxy()to a public API and integrated automatic proxy file verification during rewrite rule compilation. Introduced dedicated 1-click administrative deployment and re-deployment actions in the Server Setup control panel for rapid zero-WordPress RAM proxy provisioning. - CLOUDFLARE & REVERSE PROXY SSL SCHEME PARITY IN LUA: Enhanced the OpenResty / Lua Redis lookup template with reverse proxy and CDN Flexible SSL headers (
HTTP_CF_VISITOR,HTTP_X_FORWARDED_PROTO,HTTP_X_FORWARDED_SSL), preventing scheme mismatch misses when edge proxies terminate TLS. - MOBILE RESPONSIVE SERVER SETUP WORKFLOW (320px–782px): Hardened server status cards and rewrite action button grids with vertical flex stacking and touch-friendly tap targets for compact mobile viewports.
1.8.9 (November 1, 2026)
- PRECISION CART-FRAGMENTS SHORT-CIRCUITING: Upgraded
Woo_Guard::has_wc_cookie()andmaybe_short_circuit_fragments()to inspect cookie values rather than raw keys alone. Prevents lingering cookies with zero items (woocommerce_items_in_cart=0) or empty cart hashes from defeating short-circuiting, answering crawler and bot fragment requests in sub-millisecond time with static empty JSON before WooCommerce initializes. Seamlessly supports both GET query strings and POST payload parameters. - DUAL-HOOKED SHOP GATE ANTI-CACHING HEADERS: Upgraded
Woo_Guard::enforce_shop_gate_headers()to attach to bothsend_headersandtemplate_redirect(priority 1). Guarantees strictno-cache, no-store, must-revalidatedirectives are sent across custom, translated, and permalink-rewritten cart and checkout pages where post query conditionals resolve after initial request parsing. - EXTENSIBLE COMMERCE ACTION FILTERS: Decoupled custom e-commerce product and booking actions via new filter hooks (
lumencache_commerce_get_keysandlumencache_commerce_post_keys), allowing bespoke checkout actions, digital product intake, and booking flows to enforce anti-caching headers cleanly. - SELF-HEALING ACTIVE STATE FOR GUEST SHOPPERS: Enhanced
Cookie_Router::maybe_heal_active_state()andset_active_cookie()to detect active guest cart sessions and re-mint thesys_active_statebypass cookie for up to 48 hours (matching standard e-commerce session lifespans), preventing returning shoppers from seeing cached empty mini-carts on edge reverse proxies (Nginx, Apache, LiteSpeed, Cloudflare). - CART RESTORATION & EXPANDED LMS HOOKS: Hooked WooCommerce
woocommerce_cart_item_restored(Undo remove item) to automatically restore active session routing. Integrated course enrollment lifecycle hooks for modern LMS platforms (Tutor LMS, Sensei) alongside existing LearnDash, LifterLMS, and MemberPress drivers.
1.8.8 (November 1, 2026)
- UNIVERSAL MARKETING & ANALYTICS PARAMETER STRIPPING: Expanded the tracking parameter engine across
Cache_Engine, theadvanced-cache.phpdrop-in, andlumen-cache-proxy.phpto include modern advertising identifiers (gad_source,irclickid,epik) and automated prefix matching for allutm_*parameters (utm_source,utm_medium,utm_campaign,utm_term,utm_content,utm_id). Guarantees newsletter subscribers, campaign traffic, and ad visitors share high-speed cached HTML with organic traffic rather than triggering unwanted query-string cache bypasses. - REVERSE PROXY & CDN FLEXIBLE SSL SCHEME PARITY: Harmonized HTTPS scheme resolution across the early drop-in, server proxy, and runtime cache engine to inspect
HTTP_X_FORWARDED_SSLand CloudflareHTTP_CF_VISITOR({"scheme":"https"}). Resolves scheme mismatch cache misses where edge CDNs terminate SSL and connect to origin servers over HTTP. - REQUEST-LEVEL POST INVALIDATION DEDUPLICATION: Added intra-request static memoization to
Cache_Engine::purge_post(). Eliminates duplicate taxonomy lookups, redundant Redis key deletions, and duplicate edge CDN purge API calls when WordPress fires bothtransition_post_statusandsave_posthooks during a single content edit. - COMMENT AUTHOR STATE & EARLY ROUTE GUARDS: Integrated
comment_author_andwordpress_logged_in_cookie guards intoCache_Engine::should_bypass(), preventing pending moderation comments from being cached for public visitors. Added early/robots.txtbypasses to ensure plain-text crawler instructions bypass full-page caching. - AUTOMATIC UNIX SOCKET FALLBACK: Hardened
Redis_ConnectorandDrop_In::write_config()to automatically utilize auto-detected Unix domain sockets (/var/run/redis/redis.sock) when manual socket settings are unconfigured, providing out-of-the-box socket performance on Unix/Linux server environments. - ZERO-WRITE TELEMETRY & MODERN TAG PROTECTION: Restricted administrative transient caching to authenticated or cron contexts to preserve strict zero-write compliance on visitor GET requests. Updated output buffer micro-scrubber to tokenize and protect
<template>tags alongside scripts, styles, pre, and code blocks.
1.8.7 (November 1, 2026)
- ONE-CLICK QUICK SETUP KEY SALT GENERATION: Added direct 1-click execution for Armour Layer I cryptographic key salt generation (
lumencache_generate_salt) directly within the Quick Setup tracker on the Overview tab. Eliminates the multi-step navigation roadblock for first-time administrators by generating a cryptographically secure 32-character salt, recompiling the drop-in configuration snapshot, and activating Layer I protection in a single interaction. - SETTINGS DEEP LINKING & TARGET FOCUS: Introduced smooth scroll navigation with automated temporary focus highlight (
lc-highlight-pulse) when jumping from Quick Setup directly into specific administrative settings sections. - INLINE GENERATE & SAVE NOW ENGINE: Added instantaneous one-click “Generate & Save Now” button to the Security Hardening settings card, along with dynamic client-side generation status indicators (
✓ Key salt generated) and submit button highlight cues to eliminate user onboarding confusion. - ONBOARDING GUIDANCE & COPY HARDENING: Replaced dense cryptographic terminology with plain-language, actionable guidance across both the Quick Setup tracker and Settings tabs, explaining the role of SHA-256 key salting and providing clear next steps for unconfigured sites.
1.8.6 (October 28, 2026)
- SETTINGS ISOLATION & DATA INTEGRITY: Resolved tab settings isolation gap in administrative save handler (
class-admin.php). Submitting integration rules from the Theme & Integrations tab or saving settings from standalone forms now selectively updates only the submitted fields, guaranteeing that existing Redis connection parameters, cache salt, ETag HTTP 304 validation, and speculation rules are completely preserved. - PRE-BOOTSTRAP CONFIG SYNCHRONIZATION: Hardened drop-in configuration snapshot recompilation (
advanced-cache.phpand server proxy) immediately following targeted integration rule updates, ensuring seamless synchronization between admin console options and pre-bootstrap execution layers.
1.8.5 (October 23, 2026)
- ARCHITECTURAL ATTACK SURFACE MITIGATION: Documented zero-worker server proxy delivery mechanisms (Nginx
redis_pass/ LiteSpeed rewrites) that intercept up to 90%+ of unauthenticated requests at the web server layer, shielding PHP-FPM against automated exploit scanners and memory exhaustion during critical runtime vulnerability waves (such as php2shell / CVE-2026-109618 & CVE-2026-109619). - PRE-BOOTSTRAP DYNAMIC PORTALS & DASHBOARDS BYPASS: Hardcoded pre-bootstrap cache bypass and anti-caching Shop Gate headers across Drop-In (
advanced-cache.php) and Server Proxy (lumen-cache-proxy.php) for dynamic frontend intake forms, multi-step submission wizards, and member dashboards, eliminating token session mismatches and stale form rendering before WordPress initializes. - COMPREHENSIVE OPTION & REVIEW LIFECYCLE WATCHERS: Hardened
App_Driversto automatically watchadd_optionanddelete_optionlifecycle events in addition toupdate_optionfor custom theme options, child/parent theme mods, and site settings. Extended customer product review invalidation (/reviews/) to listen to comment trashing, untrashing, and permanent deletion events (trash_comment,untrash_comment,deleted_comment). - MOBILE UI OPTIMIZATION: Refined responsive styles for
.lc-integrations-actionsinadmin.cssensuring full-width touch targets and clean vertical stacking on mobile devices <= 600px.
1.8.4 (October 23, 2026)
- PORTABLE JSON PROFILE EXPORT & IMPORT: Added one-click Export and Import profile engine for custom integration and invalidation rules. Enables agencies and multi-site store networks running the same theme or commerce stack to export configuration profiles as portable
.jsonfiles and import them across multiple sites with automatic schema validation and drop-in recompilation. - ONE-CLICK WOOCOMMERCE PRESET: Added instant client-side WooCommerce Standard Preset loader button (
[ ⚡ Load WooCommerce Preset ]), automatically populating standard store bypasses (/track-order/,/order-tracking/,#^/my-account/orders/.*#i) and core invalidation watchers without manual typing. - PRIVACY HARDENING & VENDOR-NEUTRAL PLACEHOLDERS: Sanitized all user-facing admin examples and placeholders to adhere strictly to neutral, public WordPress/WooCommerce standards.
1.8.3 (October 23, 2026)
- UNIVERSAL THEME & INTEGRATION ENGINE: Added dedicated “Theme & Integrations” dashboard tab with live active theme diagnostic inspection (hierarchy, slug, author, version, and driver status).
- COMMERCE CAMPAIGN & REVIEW DRIVER: Added automated invalidation listeners for custom e-commerce theme options, promotional campaign custom post types (
*campaign*), and customer review wall page synchronization. - UNIVERSAL ORDER TRACKING BYPASS: Broadened universal WooCommerce route bypass regex across Drop-In (
advanced-cache.php), Server Proxy (lumen-cache-proxy.php), and Application Driver (class-app-drivers.php) to#/(cart|checkout|my-account|wc-api|track-order|order-tracking)(/?$|/)#i. - PRE-BOOTSTRAP COMPILED CUSTOM BYPASSES: Introduced declarative custom URL bypass pattern input compiled directly into
advanced-cache.phpand the server proxy duringDrop_In::write_config(), ensuring bespoke endpoints (/track-order/,/vip-portal/) bypass cache in <1ms before WordPress loads. - DECLARATIVE PURGE WATCHERS & CPT MAPPINGS: Added configurable option watchers (triggering
purge_allwhen theme or announcement options change) and custom post type purge rules (cpt => *pattern*). - DEVELOPER API HOOK & SNIPPET GENERATOR: Exposed
lumencache_register_custom_driversaction hook with live copy-pasteable PHP snippet generation in the admin console.
1.8.2 (October 21, 2026)
- SETTINGS PRESERVATION HARDENING: Resolved settings overwrite bug in
includes/class-admin.phpwhere saving settings from the standard Settings tab inadvertently reset Cloudflare configuration (cloudflare_enabled,cloudflare_zone_id) because Cloudflare fields are managed on the Pro Advanced Settings tab. - CLI FATAL RESOLUTION & HTACCESS ALIAS: Fixed fatal error in
includes/class-cli.phpwherewp lumencache statusattempted to call non-existent methodHtaccess::rules_installed(); corrected call toHtaccess::rules_written()and introducedrules_installed()alias inincludes/class-htaccess.phpfor backwards compatibility. - PROXY CONFIGURATION PARITY: Added missing default
edge_cache_ttldefinition toserver/lumen-cache-proxy.phpdefault configuration snapshot. - PRO ADVANCED SETTINGS UNIFICATION: Enriched LumenCache Pro advanced settings card with dedicated inputs for
edge_cache_ttl,speculation_rules_header_delivery,preconnect_enabled, andmicro_scrubbing_enabled. - FULL PIPELINE AUDIT VERIFICATION: Certified complete end-to-end operational integrity across Overview, Connection, Cache Controls, Settings, Server Setup, Hosting Guide, Pro License, Cache Telemetry, Effective Settings, Config Checker, and Advanced Settings tabs on desktop (1800px, 1280px) and mobile (390px) viewports.
1.8.1 (October 21, 2026)
- DYNAMIC SHOP SLUG RESOLUTION: Replaced static shop path assumptions with dynamic queries via
wc_get_page_id('shop')andget_post_field('post_name', $shop_page_id), ensuring custom shop URLs (/store/,/market/) are correctly purged without early rewrite bootstrap dependencies. - CUSTOM WOOCOMMERCE PRODUCT TYPES & BOOKINGS: Added native invalidation and rewrite patterns for custom WooCommerce product types, booking experiences, and digital courses, ensuring dedicated catalog landing hubs and category archives are automatically purged on stock and inventory transitions.
- SPECULATION RULES SELECTOR EXPANSION: Extended speculation exclusions to block dynamic commerce interaction buttons and custom product buy buttons from speculative prefetching.
- JSON DATA-ATTRIBUTE MICRO-SCRUBBING PROTECTION: Upgraded output buffer micro-scrubber to tokenize and protect all HTML
data-*attributes containing JSON or structured arrays from whitespace alteration. - EXPANDED COMMERCE SHOP GATE: Broadened
add-to-cartquery parameter check to substring match, capturing custom in-house action links.
1.8.0 (October 21, 2026)
- NEXT-GEN SPEED ENGINE & SWR: Implemented RFC-compliant Edge CDN
s-maxage=300,stale-while-revalidate=3600, andVary: Accept-Encoding, Cookieheaders on all public cache hits. - SACRED SHOP GATE: Built multi-layer commerce shield guaranteeing cart cookies (
woocommerce_items_in_cart > 0,woocommerce_cart_hash,sys_active_state=true) and dynamic routes (/cart/,/checkout/,/my-account/,*order-pay*,*wc-ajax*,*add-to-cart*) immediately bypass Redis RAM and emit strict anti-caching headers (Cache-Control: no-cache, no-store, must-revalidate, max-age=0). - REDIS DUAL-WINDOW SWR & BACKGROUND REVALIDATION: Delivers stale public hits in <1ms (
X-Cache-Status: STALE-HIT) with atomic 30-second Redis revalidation locking (reval_lock:) and non-blocking background revalidation viafastcgi_finish_request(). - INSTANT INVENTORY INVALIDATION: Hard-deletes product and shop cache entries immediately on stock updates, price changes, and order completion events.
- BUFFER MICRO-SCRUBBER: Strips developer comments and collapses redundant whitespace while protecting JSON-LD schemas, variation JSON attributes, and scripts/styles.
1.7.9 (October 19, 2026)
- HOTFIX: WooCommerce Add to Cart TypeError: In Cookie_Router::set_active_cookie(), loosened $expires parameter type from int to mixed and declared 0 accepted arguments across WooCommerce, LearnDash, LifterLMS, and MemberPress action hooks, preventing PHP 8.1+ TypeError crashes when hooks pass non-integer arguments.
1.7.8 (October 18, 2026)
- SELF-HEALING ACTIVE STATE COOKIE & MULTI-DAY PERSISTENCE: Enhanced
Cookie_Routerwith an earlyinitself-healing check (maybe_heal_active_state()). When a returning authenticated WordPress visitor opens the site after browser restart, LumenCache automatically re-mintssys_active_state=truewith a 14-day persistent lifespan, preventing edge caches (Cloudflare/Nginx) from serving cached unauthenticated pages to logged-in members.
1.7.7 (October 18, 2026)
- DYNAMIC CREATOR DASHBOARDS & SUBMISSION FORMS: Registered dedicated pre-bootstrap and runtime bypass patterns for creator dashboards, member profile management, and dynamic intake forms, ensuring real-time dynamic interactivity and preventing edge caching of user states while keeping public media archives fully cached.
1.7.6 (October 18, 2026)
- ACTIVE THEME SETTINGS INVALIDATION DRIVER: Added automated cache flush triggers when custom theme settings, site banners, and header/footer customizer options are modified in the WordPress admin.
1.7.5 (October 6, 2026)
- REST API GUEST HYDRATION RESILIENCY: Hardened
/wp-json/lumencache/v1/user-stateto gracefully isolate guest-safe keys (cart-count,cart-total) when unauthenticated requests contain mixed-key requests (such as headers rendering both cart widgets and member greetings), preventing 403 authorization rejections from breaking guest cart hydration. - LCU LMS & SENSEI COURSE PROGRESSION: Added native student course progress resolution for Light & Composition University’s LMS (
Educational_Products_LMS_Progress) and Sensei LMS, alongside existing LearnDash and LifterLMS integrations; addedlumencache_resolve_course_progressandlumencache_enqueue_hydration_scriptfilters. - SKELETON HYDRATION PROGRESS BARS & REHYDRATION API: Enhanced
skeleton-hydration.jsto dynamically update progress bar widths (role="progressbar",.lms-progress-bar,.progress-bar) and supportdata-lumencache-suffixattributes; exposedwindow.lumenCacheHydrateAPI and registeredlumencache:rehydrateevent listener for AJAX catalog pagination and mini-cart drawers. - WP-CLI STACK COMMAND ENHANCEMENTS: Added
wp lumencache flush-allsubcommand alias,--url=<url>flag support forflush-url, and enrichedwp lumencache statuswith HTTP 304 ETag status, Speculation Rules API state, storage driver, SWR grace periods, browser cache TTL, Apache/LiteSpeed RAM Proxy status, and Pro status. - WP-CLI AUTOMATION PROVISIONING: Added
wp lumencache deploy-dropin,wp lumencache remove-dropin,wp lumencache write-htaccess, andwp lumencache remove-htaccesssubcommands for automated headless server provisioning and CI/CD pipelines. - PRO COMPATIBILITY BRIDGE & DUAL HOOK DISPATCH: Restored
lc_is_pro_active()andlc_has_pro_feature()legacy function aliases; added dual hook dispatching for all five Pro administrative sections (lc_render_pro_*andlumencache_render_pro_*); added legacylumencache_render_pro_panel()andlc_render_pro_panel()compatibility bridges.
1.7.4 (October 6, 2026)
- TAB CONTINUITY & FORM REDIRECTION: Injected explicit
from_tabhidden inputs across Settings, Cache Controls (Flush All, Purge URL), and Server Setup action forms, guaranteeing that all form submissions and admin-post actions reliably redirect administrators back to their active working tab. - HTACCESS ERROR RESILIENCY: Hardened
handle_htaccess_write()to validateWP_Errorreturn states fromHtaccess::write_rules(), passing distinct error notices with diagnostic messages instead of reporting false positive success on filesystem permission failures; added distincthtaccess=removedhandling for rule deletions. - APACHE & LITESPEED SERVER SETUP CARD: Introduced dedicated “Apache / LiteSpeed Direct RAM Proxy (.htaccess)” management card on the Server Setup tab for Apache and LiteSpeed environments, providing real-time deployment status, one-click rule write/remove controls, and a copyable rewrite rules block.
- TEN SUBSYSTEMS OVERVIEW MATRIX: Expanded “Core Engine Systems” on the administrative overview to feature all ten subsystems, providing live status and operational descriptions for the new HTTP 304 & ETag Validation Engine and Next-Gen Speculation Rules API Engine.
- MULTI-DEVICE RESPONSIVENESS (<620px, <480px): Overhauled admin layout styles with responsive column-wrapping for all settings labels and input controls on viewports <=620px, single-column metrics card grid on screens <=480px, column layout for URL purges, and >=40px touch targets for mobile usability.
1.7.3 (October 6, 2026)
- INTRA-REQUEST STATE SYNCHRONIZATION: Enhanced
Cookie_Router::set_active_cookie()to immediately mirror active state into superglobal$_COOKIE['sys_active_state'] = 'true', ensuring all downstream checks and speculation suppression evaluate correctly within the identical PHP lifecycle. - RECOVERY ON CART ITEM REMOVAL: Added
woocommerce_cart_item_removedlistener toCookie_Router, automatically clearingsys_active_stateand restoring high-speed RAM caching when a guest shopper removes the final item from their cart. - REVERSE PROXY SSL RESILIENCY: Hardened cookie dispatch in
Cookie_Router::send_cookie()with full reverse proxy and Cloudflare SSL awareness (HTTP_X_FORWARDED_SSL,HTTP_CF_VISITOR), guaranteeing correctSecureattribute propagation. - SPECULATION RULES BYPASS HARDENING: Expanded
Speculation_Rules::should_render()with comprehensive suppression checks forDONOTCACHEPAGE,woocommerce_cart_hash, native WooCommerce checkout/account templates (is_cart(),is_checkout(),is_account_page()), and password-protected posts. - SPECULATION URL PATTERNS & SELECTOR EXCLUSIONS: Enhanced speculation rules schema to explicitly exclude exact
/cart,/checkout,/my-accountpaths, archive mime types (.tar*,.gz*), and link downloads (a[download]). - SANITIZED AJAX FRAGMENTS HANDLING: Hardened
Woo_Guard::maybe_short_circuit_fragments()with query parameter sanitization (sanitize_text_field( wp_unslash( ... ) )).
1.7.2 (October 6, 2026)
- QUERY OPTIMIZATION: Eliminated redundant MySQL transient deletion on frontend cache writes (
Redis_Connector::set()), preventing database churn and maintaining 15-second key count caching exclusively for the administrative dashboard. - OUTPUT BUFFER COLLAPSE: Added nested output buffer level tracking (
$capture_buffer_level) inCache_Engine, safely collapsing unclosed third-party template and widget buffers prior to cache capture. - ERROR RECOVERY HARDENING: Extended fatal error detection in output buffer shutdown hook to intercept
E_RECOVERABLE_ERROR, guaranteeing incomplete or faulted pages are never committed to cache. - DEDICATED BLOG & AUTHOR INVALIDATION: Added surgical cache purging for static front page blog listings (
page_for_posts) and post author archives (get_author_posts_url), ensuring archives immediately reflect newly published and updated articles. - SLASHED & UNSLASHED KEY PURGE PARITY: Expanded
purge_post()andpurge_url()to invalidate both trailing-slashed and unslashed canonical Redis keys in a single atomic batchedDELcommand. - REVERSE PROXY SSL EXPANSION: Extended HTTPS scheme detection to support
HTTP_X_FORWARDED_SSLand CloudflareHTTP_CF_VISITORpayloads across write paths and URL purges. - DEACTIVATION & UNINSTALL HYGIENE: Enhanced
Lifecycle::deactivate()andLifecycle::uninstall()to automatically flush Redis cache keys and clean up all transient caches (lumencache_key_count,lumencache_nginx_confirmed,lumencache_qs_bridge_check). - REDIS SCAN BOUNDS: Added iteration bounds to
Redis_Connector::key_count()anddelete_pattern()to defend against runaway driver loops during full-keyspace cursor traversal.
1.7.1 (October 6, 2026)
- HTTP HEAD METHOD SUPPORT: Enabled early RAM cache HIT handling for HTTP HEAD requests across both advanced-cache.php drop-in and server/lumen-cache-proxy.php, serving accurate response headers in <1ms without body transfer and eliminating unnecessary WordPress bootstrap on crawler/probe checks.
- RFC 7232 CONDITIONAL GET HARDENING: Expanded If-None-Match evaluation to seamlessly support unquoted ETags, wildcard asterisk (*), and multi-tag header values, preventing accidental cache re-downloads.
- PREDIS AUTOLOADER RESOLUTION: Hardened early autoloader path resolution to respect custom WP_PLUGIN_DIR definitions before falling back to WP_CONTENT_DIR/plugins.
- HEADERS_SENT DEFENSE: Wrapped proxy header emission in defensive headers_sent() check to prevent PHP runtime notices.
1.7.0 (October 6, 2026)
- SPECULATION RULES API ENGINE: Introduced next-generation browser speculation rules (
<script type="speculationrules">) delivering sub-50ms instant page navigation via Chromium background prefetching and prerendering, fully accelerated by sub-millisecond RAM cache delivery. - CONDITIONAL GET & HTTP 304 NOT MODIFIED: Added native ETag generation and
If-None-Matchvalidation directly into early drop-in and proxy readers, terminating repeat requests withHTTP 304 Not Modifiedand 0 bytes transfer. - RFC 5861 STALE-WHILE-REVALIDATE & EDGE HEADERS: Emitted modern
Cache-Control: public, max-age=..., stale-while-revalidate=...headers for browser caches and edge CDN proxies. - WORDPRESS.ORG PLUGIN CHECK COMPLIANCE: Hardened input attribute rendering, added translator comments across all internationalized placeholders, namespaced pro compatibility surfaces, and cleared 100% of repository linter errors.
- EARLY DROP-IN PREDIS BOOTSTRAP: Resolved silent drop-in bail-out in environments without
ext-redisPHP extension. Bothadvanced-cache.phpandserver/lumen-cache-proxy.phpnow detect and load LumenCache’s bundled Predis autoloader (wp-content/plugins/lumen-cache/vendor/autoload.php) before early bail-out checks. - RAM HIT RATIO AUDIT & CERTIFICATION: Verified RAM cache hit-rate scaling from 0% past the 98% target (certified at 98.1% across 150+ requests with 0 DB queries on hits).
1.6.35 (October 6, 2026)
- EARLY DROP-IN PREDIS BOOTSTRAP: Resolved silent drop-in bail-out in environments without
ext-redisPHP extension. Bothadvanced-cache.phpandserver/lumen-cache-proxy.phpnow detect and load LumenCache’s bundled Predis autoloader (wp-content/plugins/lumen-cache/vendor/autoload.php) before early bail-out checks. - RAM HIT RATIO AUDIT & CERTIFICATION: Verified RAM cache hit-rate scaling from 0% past the 98% target (certified at 98.1% across 150+ requests with 0 DB queries on hits).
- PRO TELEMETRY COUNTER HARMONIZATION: Verified real-time telemetry incrementing across
advanced-cache.php,lumen-cache-proxy.php, andclass-cache-engine.phpwith 0 transport latency. - DROP-IN DEPLOYER RE-SYNC: Updated
Drop_In::deploy()template to preserve the bundled autoloader fallback on redeployments and settings compiles.
1.6.34 (September 15, 2026)
- PRO COMPATIBILITY: Hardened
lumencache_is_pro_active()to verifydefined( 'LUMENCACHE_PRO_VERSION' ) && get_option( 'lumencache_pro_status' ) === 'active', preventing false positive status if the Pro add-on is deactivated or uninstalled. - CLOUDFLARE EDGE SYNC: Hooked
lumencache_purge_urlsinto single-URL purge operations (purge_url), ensuring Admin Bar “Purge This URL” and WP-CLIflush-urlactions automatically purge Cloudflare edge cache alongside local Redis. - APACHE & LITESPEED TELEMETRY: Added Pro hit-counter telemetry parity to the pre-bootstrap proxy (
server/lumen-cache-proxy.php) on cache HITs, and updatedDrop_In::write_config()to synchronize compiledpro_activestate to deployed proxy files. - ADMIN ACTIONS CONTEXT: Injected
from_tabretention to the Cloudflare purge form on the Cache Controls page, keeping administrators on their current tab after purging.
1.6.33 (September 15, 2026)
- ADMIN BAR: Added contextual “Purge This URL” sub-node when viewing frontend content, enabling instant single-URL cache invalidation directly from the toolbar without flushing the entire site.
- DASHBOARD WIDGET: Retained administrator on
wp-admin/index.phpafter flushing cache viaredirect_tohandling, complete with dismissible success notice and refined button hover styling. - WP-CLI: Enhanced
wp lumencache statuswith--formatsupport (table, json, yaml, csv) and drop-in /WP_CACHEstatus visibility; alignedflush-urloutput with semantic WP-CLI warning conventions. - REST API & HOLE-PUNCHING: Automated WooCommerce cart and session initialization (
wc_load_cart) during REST API user-state hydration requests; added LifterLMS course-progress resolution support. - REST API EXTENSIBILITY: Introduced
lumencache_user_state_keysandlumencache_resolve_user_state_{$key}filters for developer extensibility. - NONCE HARDENING: Supported both query parameter and
X-WP-Nonceheader authentication across REST user-state hydration and Admin Bar AJAX flush handlers.
1.6.32 (September 15, 2026)
- SETTINGS & CONNECTION TEST: Added native AJAX Redis connection testing (
lumencache_test_redis) supporting both phpredis and Predis drivers, Unix sockets, host/port, database indexes, connection timeouts, and authentication passwords. - UI & TAB NAVIGATION: Implemented seamless browser URL synchronization (
history.replaceState) on sidebar tab switches, preventing stale tab states across page reloads. - QUICK SETUP TRACKER: Enabled 1-click execution for Apache / LiteSpeed rewrite rule generation directly from the Quick Setup Tracker on the Overview tab, eliminating unnecessary navigation steps.
- ADMIN ACTION REDIRECTS: Added contextual
tabandfrom_tabstate retention across all admin actions (cache flushes, drop-in deployment, settings save, salt save, and rewrite operations), preserving the user’s active view after every submission. - SETTINGS HARDENING: Enhanced password field handling to preserve special characters and ensured default namespace fallback (
cache:) when clearing key prefix. - SETTINGS CACHE: Added
Settings::reset_cache()method to reset in-process configuration memory.
1.6.31 (September 15, 2026)
- NGINX: Synchronized
nginx_map_block()and sample Nginx configurations withwp-postpass_andcomment_author_cookie bypass rules, preventing cached responses for unlocked password-protected posts and returning commenters. - APACHE & LITESPEED: Enhanced
.htaccessrewrite rules to directly exclude/feed/requests and XML sitemaps before proxy evaluation, avoiding unnecessary PHP execution overhead. - APACHE & LITESPEED: Added explicit
wp-postpass_andcomment_author_cookie rewrite conditions to.htaccessconfiguration. - PROXY DEPLOYMENT: Hardened
Htaccess::deploy_proxy()to verify and ensure target upload directory existence withwp_mkdir_p(). - PRE-BOOTSTRAP PROXY & DROP-IN: Aligned socket connection timeouts,
\Redis::OPT_READ_TIMEOUT, Predisread_write_timeout, andcomment_author_cookie bypass across bothserver/lumen-cache-proxy.phpandserver/advanced-cache.php.
1.6.30 (September 15, 2026)
- TIMEOUT: Added explicit connection and read timeouts for phpredis (
\Redis::OPT_READ_TIMEOUT) and Predis (read_write_timeout) to protect PHP worker processes from hanging on stalled Redis operations. - SOCKETS: Added explicit timeout to phpredis Unix socket connections and cleaned up TCP host/port parameters on Predis socket connections.
- LATENCY & QUERY OPTIMIZATION: Implemented in-memory memoization and transient caching for
key_count()to eliminate redundant full-keyspace SCAN operations across admin page views. - ARRAY SAFETY: Hardened
delete()anddelete_pattern()against PHP 8.1+ argument unpacking errors by guaranteeing integer-indexed array keys witharray_values(). - TELEMETRY: Standardized memory extraction in
memory_used()across both phpredis and Predis drivers for accurate RAM usage reporting. - RECONNECT: Added
reconnect()andget_prefix()helper methods toRedis_Connector.
1.6.29 (September 15, 2026)
- FIX: Protected logged-in sessions in Cookie Router (
clear_active_cookie()) when WooCommerce cart is emptied or subscriptions stop, ensuringsys_active_statecookie is preserved while user remains logged in. - FIX: Expanded WooCommerce bypass routes across early drop-in, proxy, and application drivers to include
/wc-api/to safeguard payment gateway callbacks and webhooks from being cached. - FIX: Hooked
woocommerce_variation_set_stockto immediately purge stale caches when variable product inventory levels are updated. - HARDENING: Dynamic cookie path and domain resolution in
send_cookie()with reverse proxy HTTPS detection viaHTTP_X_FORWARDED_PROTO.
1.6.28 (September 15, 2026)
- FIX: Added universal WordPress DONOTCACHEPAGE constant compliance in both bypass decision and shutdown write checks.
- FIX: Added contextual bypass checks in Cache_Engine for 404 pages, post draft previews, customizer previews, robots.txt, trackbacks, XML-RPC, and password-protected posts (
wp-postpass_cookie). - HARDENING: Added PHP fatal error detection (
error_get_last()) during output buffer capture to guarantee broken pages or fatal errors are never written to cache. - INVALIDATION: Added surgical invalidation for post status transitions (
transition_post_status) so unpublishing or trashing a post immediately clears its cached HTML from Redis. - INVALIDATION: Added post comment and review invalidation hooks (
comment_post,edit_comment,wp_set_comment_status,delete_comment,trashed_comment,spammed_comment) andcreated_term. - PERFORMANCE: Optimized post purging with batched multi-key Redis DEL execution and automated invalidation of all taxonomy archive URLs (categories, tags) associated with the updated post.
- REVERSE PROXY: Aligned HTTPS scheme detection across Cache_Engine, advanced-cache.php, and lumen-cache-proxy.php behind SSL-terminating reverse proxies.
1.6.27 (September 15, 2026)
- FIX: Synchronized pre-bootstrap Apache/LiteSpeed proxy (
lumen-cache-proxy.php) with complete feed bypass rules (/feed/and?feed=) to prevent XML feeds from caching as HTML. - FIX: Expanded XML sitemap bypass in both
advanced-cache.phpandlumen-cache-proxy.phpto cover core WordPress (wp-sitemap), standard sitemaps (sitemap_index), and paginated variants. - FIX: Automated compiled configuration snapshot synchronization into deployed
wp-content/uploads/lumen-cache-proxy.phpon file deployment and settings save.
1.6.26 (September 15, 2026)
- DOCS: Added Nginx 502 Bad Gateway troubleshooting FAQ and recommended 32KB FastCGI/Proxy buffer configuration directives.
- SERVER CONFIG: Updated Nginx global and per-site templates with 32k FastCGI and Proxy buffer directives to eliminate “upstream sent too big header” errors.
- UI: Added high-performance buffer configuration callout in Server Setup and Hosting Guide for Plesk and Nginx + PHP-FPM environments.
- PRO: Added Nginx FastCGI buffer size recommendation to Config Consistency Checker.
1.6.25 (September 4, 2026)
- FEATURE: Added mobile admin bar quick-action button adjacent to native new-content icon (hook priority 71) with responsive display on viewports <= 782px.
- UI: Integrated dashicons-performance tachometer icon inside a touch-friendly 46px target with live Redis connection indicator dot.
- UX: Implemented …
