{"id":256193,"date":"2026-01-25T16:32:42","date_gmt":"2026-01-25T16:32:42","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/quantumcache\/"},"modified":"2026-04-03T14:21:17","modified_gmt":"2026-04-03T14:21:17","slug":"quantumcache","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/quantumcache\/","author":23382050,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.1.7","stable_tag":"0.1.7","tested":"6.9.4","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"QuantumCache","header_author":"Aaron DeLong","header_description":"Deterministic, tag-based query & fragment caching for anonymous traffic. Redis preferred with MySQL fallback. Prevents wp_options\/wp_postmeta bloat.","assets_banners_color":"","last_updated":"2026-04-03 14:21:17","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/paypal.me\/quantumcache","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":217,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.5":{"tag":"0.1.5","author":"adelong01","date":"2026-01-25 16:30:33"},"0.1.6":{"tag":"0.1.6","author":"adelong01","date":"2026-03-02 20:45:38"},"0.1.7":{"tag":"0.1.7","author":"adelong01","date":"2026-04-03 14:21:17"}},"upgrade_notice":{"0.1.2":"

Admin refinements, PHPCS compliance, Redis purge, and safer URI handling.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3447166,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3447166,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.5","0.1.6","0.1.7"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Settings page showing store mode and Redis options.","2":"Cache statistics and purge controls.","3":"Network panel showing X-QC-*<\/code> debug headers."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[144,153,441,247,45952],"plugin_category":[52,54,59],"plugin_contributors":[254636],"plugin_business_model":[],"class_list":["post-256193","plugin","type-plugin","status-publish","hentry","plugin_tags-caching","plugin_tags-database","plugin_tags-multisite","plugin_tags-performance","plugin_tags-redis","plugin_category-performance","plugin_category-security-and-spam-protection","plugin_category-utilities-and-tools","plugin_contributors-adelong01","plugin_committers-adelong01"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/quantumcache\/assets\/icon-128x128.png?rev=3447166","icon_2x":"https:\/\/ps.w.org\/quantumcache\/assets\/icon-256x256.png?rev=3447166","generated":false},"screenshots":[],"raw_content":"\n

QuantumCache accelerates WordPress by caching database query results and content fragments used to build pages. Instead of caching entire HTML pages, it reduces the database work required to render pages while preserving WordPress\u2019s native invalidation behavior.<\/p>\n\n

It is not<\/em> an output buffer or page cache, and it does not replace existing page caching solutions.<\/p>\n\n

Features<\/h3>\n\n
    \n
  • Caches the results of the main front-end WP_Query<\/code> for anonymous requests.<\/li>\n
  • Tag-based invalidation: purge by post ID, post type, or taxonomy.<\/li>\n
  • Fragment caching for the_content<\/code> (classic) and core blocks such as core\/post-content<\/code>, core\/latest-posts<\/code>, core\/archives<\/code>, and core\/navigation<\/code>.<\/li>\n
  • Multiple storage modes:\n\n
      \n
    • Auto \u2013 use Redis if available, otherwise fall back to MySQL.<\/li>\n
    • Redis \u2013 fastest mode; uses the PHP Redis extension.<\/li>\n
    • MySQL \u2013 portable fallback using compact tables (qc_entries<\/code>, qc_tagmap<\/code>).<\/li>\n<\/ul><\/li>\n
    • Compatible with the Redis Object Cache drop-in.<\/li>\n
    • Avoids wp_options and postmeta storage \u2013 all cache data is stored in Redis or\nQuantumCache-owned database tables.<\/li>\n
    • Multisite-aware: per-site prefixes and per-site tables.<\/li>\n
    • WP-CLI commands: wp quantumcache flush<\/code> and wp quantumcache status<\/code>.<\/li>\n
    • Metrics data layer: persistent hit, miss, store, and purge event counters available via Metrics::totals()<\/code> and Metrics::deltas()<\/code>.<\/li>\n<\/ul>\n\n

      Performance summary<\/h3>\n\n

      In benchmarks on a plugin-heavy WordPress site (WooCommerce + Yoast SEO),\nQuantumCache reduced per-request database queries by up to ~99% on cached pages\nand achieved cache hit rates exceeding 97% with Redis.<\/p>\n\n

      In the benchmark environment:<\/p>\n\n

        \n
      • Redis mode reduced warm TTFB by roughly 23\u201327%<\/strong> and total response time by 18\u201321%<\/strong> versus an uncached baseline.<\/li>\n
      • MySQL fallback mode delivered modest improvements (~3\u201310%)<\/strong> when Redis was unavailable.<\/li>\n<\/ul>\n\n

        Actual results depend on theme complexity, plugin load, database topology, and traffic patterns.<\/p>\n\n

        When to use QuantumCache<\/h3>\n\n

        QuantumCache is useful when:<\/p>\n\n

          \n
        • Your site already uses a page cache (such as a CDN, reverse proxy, or caching plugin) but WordPress still performs significant database work.<\/li>\n
        • You want faster response times without relying solely on full-page caching.<\/li>\n
        • Your hosting environment supports Redis, or you want a portable MySQL fallback.<\/li>\n<\/ul>\n\n

          QuantumCache complements page caching rather than replacing it.<\/p>\n\n

          What QuantumCache does NOT do<\/h3>\n\n

          QuantumCache is not a page cache or full HTML cache.<\/p>\n\n

          It does not replace solutions such as:\n* CDN caching\n* reverse proxy caches\n* traditional WordPress page caching plugins<\/p>\n\n

          Instead, QuantumCache reduces the database work required to build pages, making those systems more effective.<\/p>\n\n

          Debug headers (optional)<\/h3>\n\n

          Enable Settings \u2192 QuantumCache \u2192 Send X-QC debug headers<\/em> to view cache status in HTTP responses:\n* X-QC-Main: HIT | MISS | STORE<\/code>\n* X-QC-Store: AUTO | redis | mysql<\/code>\n* X-QC-Hydrated:<\/code> number of posts loaded from cache<\/p>\n\n

          Append ?qc_nocache=1<\/code> to any URL to bypass caching for that request.<\/p>\n\n

          Debug headers are sent only when explicitly enabled in settings and contain no\npersonal or user-specific data.<\/p>\n\n

          WP-CLI commands<\/h3>\n\n

          QuantumCache provides the following WP-CLI commands:<\/p>\n\n

          wp quantumcache status\nShows the active backend, storage mode, and lifetime cache counters.<\/p>\n\n

          wp quantumcache flush\nClears all cache entries for the current site.<\/p>\n\n

          Use --yes to skip the confirmation prompt.<\/p>\n\n

          QuantumCache Pro<\/h3>\n\n

          QuantumCache Pro extends the core engine with advanced caching capabilities for WooCommerce and logged-in users.<\/p>\n\n

          See: https:\/\/quantumcache.io<\/p>\n\n

          Privacy<\/h3>\n\n

          QuantumCache does not collect, send, or log personal data.
          \nIt stores cache entries in Redis or its own MySQL tables.
          \nOther plugins on your site may handle cookies or data independently.\nNo remote requests are made, and no data is transmitted to external servers.<\/p>\n\n\n

            \n
          1. Upload the quantumcache<\/code> folder to \/wp-content\/plugins\/<\/code> and activate it.<\/li>\n
          2. (Optional) You may install the Redis Object Cache plugin for additional Redis features. QuantumCache works independently.<\/li>\n
          3. Go to Settings \u2192 QuantumCache<\/em>:\n\n
              \n
            • Choose a store mode: Auto, Redis, or MySQL.<\/li>\n
            • Configure Redis host\/port if not already set by constants.<\/li>\n
            • Optionally enable debug headers.<\/li>\n<\/ul><\/li>\n
            • Load a public page twice. On the second load, the response should include X-QC-Main: HIT<\/code>.<\/li>\n<\/ol>\n\n\n
              \n

              Does it cache logged-in users?<\/h3><\/dt>\n

              No. QuantumCache focuses on anonymous (front-end) traffic to ensure safe invalidation. Logged-in caching is not included.<\/p><\/dd>\n

              Do I need Redis?<\/h3><\/dt>\n

              Redis is recommended for best performance, but not required. QuantumCache automatically falls back to its internal MySQL store.<\/p><\/dd>\n

              Does it cache admin pages, feeds, or searches?<\/h3><\/dt>\n

              No. Those are intentionally excluded.<\/p><\/dd>\n

              Is it Multisite-compatible?<\/h3><\/dt>\n

              Yes. Each site uses its own prefix and tables. Purge actions apply per site.<\/p><\/dd>\n

              How do I purge the cache?<\/h3><\/dt>\n

              From Settings \u2192 QuantumCache<\/em>:\n* Purge Everything \u2013 clears all QuantumCache entries for this site.\n* Purge by Tag \u2013 e.g. post:123<\/code> or taxonomy:category<\/code>.\n* Purge by URL \u2013 resolves to post\/taxonomy tags automatically.<\/p>\n\n

              From the command line via WP-CLI: wp quantumcache flush<\/code><\/p><\/dd>\n

              Can I manage QuantumCache from the command line?<\/h3><\/dt>\n

              Yes. Two WP-CLI commands are available:\n* wp quantumcache flush<\/code> \u2013 clear all entries for the current site (prompts for confirmation; use --yes<\/code> to skip).\n* wp quantumcache status<\/code> \u2013 display backend, storage stats, and lifetime hit\/miss\/store\/purge counters.<\/p><\/dd>\n

              Which fragments are cached?<\/h3><\/dt>\n
                \n
              • Classic themes \u2013 the_content<\/code> on singulars.<\/li>\n
              • Block themes \u2013 core\/post-content<\/code> and common navigation\/listing blocks.<\/li>\n<\/ul><\/dd>\n

                Does it cache dynamic content or nonces?<\/h3><\/dt>\n

                No. Fragments containing nonces, tokens, or user-specific data are skipped automatically.<\/p><\/dd>\n

                Does this replace my page cache or CDN?<\/h3><\/dt>\n

                No. QuantumCache operates below page caches and CDNs by reducing database and\nrendering overhead. It is designed to complement, not replace, page caching\nsolutions.<\/p><\/dd>\n

                What happens on uninstall?<\/h3><\/dt>\n

                Unless the quantumcache_preserve_data_on_uninstall<\/code> filter returns true, QuantumCache removes its own tables and options. No wp_options or postmeta entries are left behind.<\/p><\/dd>\n\n<\/dl>\n\n\n

                0.1.7<\/h4>\n\n
                  \n
                • Fixed: RedisStore::purgeAll() was referencing the wrong internal property ($this->redis instead of $this->r), causing all bulk purge calls from the admin \"Purge Everything\" button to silently fail and return 0 keys removed.<\/li>\n
                • Fixed: MySQLStore::purgeAll() was not implemented; the admin \"Purge Everything\" button showed \"backend does not support bulk purge\" on MySQL\/Auto installs. Both qc_entries and qc_tagmap are now cleared correctly.<\/li>\n
                • Fixed: Stats::mysql_stats() queried a non-existent column (created_at) instead of the correct column (updated); this caused the Entries count in the admin Overview table to always display 0 for MySQL-backed installs.<\/li>\n
                • Major improvements to fragment caching behavior, new WP-CLI tooling, and internal metrics support.<\/li>\n
                • Perf: Added FragmentCache::peek() for pre-render cache check without lock or producer execution.<\/li>\n
                • Fixed: Fragment cache key role dimension now uses a sorted role list before implode, preventing cache misses for users with multiple roles due to non-deterministic array key order in $user->roles (FragmentCache.php).<\/li>\n
                • Feature: Added WP-CLI support \u2014 wp quantumcache flush<\/code> clears all cache entries for the current site (with confirmation prompt, or --yes to skip); wp quantumcache status<\/code> reports backend, storage stats, and lifetime event counters.<\/li>\n
                • Feature: Added Metrics data layer tracking split query and fragment hit, miss, store, and purge event counts with atomic wp_options persistence; exposes Metrics::deltas() for current-request data and Metrics::totals() for cumulative counters.<\/li>\n
                • Dev: Added quantumcache_cache_hit, quantumcache_cache_miss, and quantumcache_cache_store action hooks at each cache outcome point in QueryCache and FragmentCache, available for Pro and third-party extensions.<\/li>\n
                • Fixed: Changed singular query alias cache keys so they respect the logged-in role cache bucket, preventing anonymous singular alias entries from satisfying logged-in requests and preventing proper role-scoped primary key creation.<\/li>\n<\/ul>\n\n

                  0.1.6<\/h4>\n\n
                    \n
                  • Fix: Corrected QUANTUMCACHE_VERSION constant value to match plugin header (was 0.1.4).<\/li>\n
                  • Compat: Fire quantumcache_loaded action after plugin init so Pro and third-party extensions can reliably detect when Free has finished bootstrapping. <\/li>\n<\/ul>\n\n

                    0.1.5<\/h4>\n\n
                      \n
                    • Security: Hardened direct database access by validating and escaping internal\ntable identifiers to satisfy PluginCheck and reviewer requirements.<\/li>\n
                    • Code: Resolved all PluginCheck warnings; no functional behavior changes.<\/li>\n
                    • Cleanup: Removed development-only tooling files from the release package.<\/li>\n
                    • Stability: Minor internal cleanup following load testing and runtime validation.\nextensions can reliably detect when Free has finished bootstrapping.<\/li>\n<\/ul>\n\n

                      0.1.4<\/h4>\n\n
                        \n
                      • Fix: Fixed incomplete Stats.php code concerning MySQL reporting<\/li>\n
                      • Fix: Prefixed all global functions and variables (qc_* \u2192 quantumcache_*) to satisfy Plugin Check naming requirements.<\/li>\n
                      • Fix: Updated uninstall routine to use prefixed globals and updated option names.<\/li>\n
                      • Fix: Added defensive table-name validation and explicit casting in Maintenance and Stats to address Plugin Check warnings.<\/li>\n
                      • Fix: Corrected several internal calls referencing the old function names (qc_should_debug_headers, etc.), preventing runtime errors.<\/li>\n<\/ul>\n\n

                        0.1.3<\/h4>\n\n
                          \n
                        • Fix: Updated MySQLStore write operations to use $wpdb->insert() with format arrays, resolving the PHPCS \/ reviewer-required change.<\/li>\n
                        • Fix: Corrected StoreFactory to pass the required $wpdb instance when constructing MySQLStore, restoring MySQL fallback functionality.<\/li>\n<\/ul>\n\n

                          0.1.2<\/h4>\n\n
                            \n
                          • Admin: refined settings layout, help text, and capability\/nonce checks.<\/li>\n
                          • Code: PHPCS\/WPCS compliance (sanitization, escaping, Yoda, no short ternaries).<\/li>\n
                          • Store: Redis \u201cPurge Everything\u201d via SCAN\/DEL with site prefix.<\/li>\n
                          • Store: MySQL tag mapping writes via wpdb->insert()<\/code> with formats.<\/li>\n
                          • Read path: safe request URI normalization for keys and display.<\/li>\n<\/ul>\n\n

                            0.1.1<\/h4>\n\n
                              \n
                            • Fix: hydration logic in on_posts_pre_query()<\/code> (now primes and hydrates safely).<\/li>\n
                            • Perf: archive hit path uses update_post_caches()<\/code> without taxonomy overhead.<\/li>\n
                            • Safety: skip caching very small archives (fewer than 12 IDs).<\/li>\n
                            • Headers: ensure X-QC-Store-Actual<\/code> reflects real backend.<\/li>\n<\/ul>\n\n

                              0.1.0<\/h4>\n\n
                                \n
                              • Initial public release.<\/li>\n
                              • Query-level caching with tag-based invalidation.<\/li>\n
                              • Fragment caching for the_content<\/code> and key blocks.<\/li>\n
                              • Redis (preferred) and MySQL stores.<\/li>\n
                              • Multisite support.<\/li>\n
                              • Admin UI: store selection, Redis config, debug headers, purge controls, live stats.<\/li>\n
                              • PHPCS clean (WordPress coding standards).<\/li>\n<\/ul>","raw_excerpt":"Speeds up WordPress by caching database queries and fragments for anonymous visitors using Redis or MySQL, without storing cache data in wp_options.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/256193","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=256193"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/adelong01"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=256193"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=256193"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=256193"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=256193"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=256193"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=256193"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}