LumenCache
| 开发者 |
nasruleam
celsiusanderson |
|---|---|
| 更新时间 | 2026年8月23日 08:57 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
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.
常见问题:
Why are 0 pages cached?
Two common causes:
- Nginx config not applied — visit Server Setup and paste the config blocks.
- 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).
更新日志:
1.6.24 (August 23, 2026)
- COMPATIBILITY: Tested and verified full compatibility with WordPress 7.1.
- PERFORMANCE: Verified pre-bootstrap drop-in execution, cache purging hooks, and REST API user-state endpoints on WordPress 7.1.
- SECURITY: Added explicit ABSPATH direct access guard to
server/lumen-cache-proxy.php. - IMPROVEMENT: Updated
Htaccess::deploy_proxy()to automatically configure localized ABSPATH definitions upon file deployment.
- COMPLIANCE: Full compliance with WordPress.org Guideline 5; streamlined UI with clean external Pro link.
- DROP-IN:
advanced-cache.phpis now completely self-contained with compiled configuration snapshot data. - SANITIZATION: Strict input and header sanitization against CRLF injection across all pre-bootstrap request paths.
- HOUSEKEEPING: Updated Plugin URI to point to the official Dev Lab page.
- FIX: Adjusted Quick Setup step flex rules in
assets/css/admin.cssto prevent connector lines from overlapping labels.
- FIX: Replaced WordPress functions in
lumen-cache-proxy.phpwith native PHP casts since the proxy runs pre-bootstrap. - FIX: Corrected root path calculation (
LUMENCACHE_PROXY_ABSPATH) for WordPressindex.phpandwp-config.phpinclusion.
- FIX: Added return value check on
$redis->auth()and$redis->select()inconnect_phpredis().
- PERF: Guarded debug string concatenation behind an explicit
LUMENCACHE_DEBUGcheck for zero production overhead.
- FIX: Replaced non-existent WordPress helper calls in
advanced-cache.phpwith native PHP casts and isset checks. - FIX: Corrected
enable_wp_cache()string replacement logic for reliableWP_CACHEinsertion intowp-config.php.
- FIX:
Lifecycle::uninstall()now flushes all Redis keys before removing plugin files. - FIX: Corrected connection source label in Settings for manually-entered host/port settings.
- SECURITY: Added direct file access protection via
ABSPATHcheck to all server drop-ins. - SANITIZATION: Sanitized all
$_SERVERinputs across pre-bootstrap request paths.
- FIX: Prevented RSS/Atom feeds from caching to avoid incorrect
Content-Type: text/htmlresponse headers. - FIX: Hardened URL sanitization in manual cache purge handler using
esc_url_raw().
- NEW: Built-in WooCommerce cart-fragments guard against crawler-triggered fragment storms.
- COMPLIANCE: Standardized update delivery on the official WordPress.org channel.
- DOCS: Added direct SSH installation instructions for Plesk in the Hosting Guide.
- NEW: Added RAM Cache Engine connectivity check to Quick Setup and introduced the Hosting Guide tab.
- IMPROVED: Quick Setup tracker review drawer for active, fully-configured sites.
- NEW: Added interactive 4-step Quick Setup progress tracker on the Overview tab.
- FIX: Aligned admin card headers and status badges across dashboard screens.
- SECURITY: Synchronized MemberPress session cookie matching across Nginx, Apache, and PHP drivers.
- FIX: Updated navigation references and doc comments for modular settings architecture.
- UX: Refined dashboard sidebar layout with dedicated feature navigation panels.
- CRITICAL: Added foreign drop-in protection to prevent overwriting existing third-party cache drop-ins.
- FIX: Aligned Redis timeout defaults and safety bypasses for dynamic/personal routes across all readers.
- FIX: Added non-HTML response rejection to prevent caching API/JSON payloads as HTML.
- IMPROVED: Refined update channel integration for WordPress.org directory hosting.
- UX: Instant click-to-show tabs across dashboard navigation.
- FIX: Fixed Admin Bar quick link URL routing.
- ARCHITECTURE: Split into clean Standard core with modular action/filter extensibility.
- UX: Single-page admin navigation shell with collapsible sidebar.
- FIX: Corrected LiteSpeed / OpenLiteSpeed server detection order.
- FIX: Added safe commented placeholders for salted Nginx configurations.
- NEW: Added Cloudflare edge cache purge integration support.
- NEW: Added cache telemetry diagnostics, bypass-reason counters, and connection test tooling.
- NEW: Automatic detection and bypass integration for XML sitemaps.
- NEW: Automatic application driver integration for educational courses and custom post types.
- COMPATIBILITY: Verified compatibility with WordPress 7.0 and PHP 8.5.
- FIX: Intelligent handling of all three
WP_CACHEstates inwp-config.phpand automated cleanup on deactivation.
- UX: Added context-aware validation for Nginx key salting configurations.
- UX: Context-aware badges in Security Hardening Matrix and direct key salt generator.
- FIX: Added tracking-parameter stripping to Apache proxy to maintain parity with PHP cache keys.
- CRITICAL: Fixed phpredis
SCANcursor handling inkey_count()anddelete_pattern().
- FIX: Automated stripping of 14 marketing tracking query parameters (Google Shopping, Meta Ads, etc.).
- FIX: Added connection return validation in
connect_phpredis()and refined Unix socket handling.
- FIX: Output buffering rebuild for PHP-FPM and Nginx FastCGI environments.
- NEW: Standalone
advanced-cache.phpdrop-in deployment with zero server configuration requirements.
- NEW: Admin settings interface, Admin Bar menu, and WP Dashboard widget.
- FIX: Resolved WooCommerce session cookie over-bypass for dramatic cache hit rate improvements.
- Initial public release.