README

High-performance full-page caching for WordPress using Redis, ValKey, KeyDB, or Dragonfly.

MilliCache stores complete HTML pages in memory and serves them in under 10ms — without loading WordPress. Combined with intelligent cache flags and flexible rules, it's designed for sites that need both speed and control.

Important

This plugin is approaching a stable release. Please report any issues you encounter.

Key Features

• Lightning Fast — In-memory caching with sub-10ms response times
• Cache Flags — Tag pages for precise, targeted cache invalidation
• Flexible Rules — Control caching behavior with condition-based rules
• Multisite Ready — Per-site isolation, network-wide management
• Horizontal Scaling — Multiple web servers can share a single Redis instance
• WP-CLI Integration — Full command-line cache management
• Multiple Backends — Redis, ValKey, KeyDB, or Dragonfly

Quick Start

1. Install via ZIP download or Composer:

   composer require millipress/millicache

2. Activate the plugin in WordPress admin

3. Enable caching in wp-config.php:

   define( 'WP_CACHE', true );
   
   // Optional: Configure Redis connection
   define( 'MC_STORAGE_HOST', '127.0.0.1' );
   define( 'MC_STORAGE_PORT', 6379 );

4. Verify in Settings UI, Browser Developer Tools, or with WP-CLI:

   wp millicache test
   wp millicache status

Documentation

Full documentation is available in the docs/ folder:

Requirements

• PHP 7.4+ (8.x recommended)
• WordPress 5.6+
• Redis-compatible server (Redis, ValKey, KeyDB, or Dragonfly)

Testing

MilliCache uses PHPUnit, PHPStan, and Playwright for testing. To run tests locally:

# Start test environment (requires Docker + Node.js)
npm install
npm run env:start

# Run e2e tests
npm run env:e2e

# Stop environment
npm run env:stop

Test WordPress available at http://localhost:8888 (login: admin / password)

Useful Commands

npm run env:cli wp millicache stats    # Run WP-CLI commands
npm run env:redis-cli                  # Open Redis CLI
npm run env:reset                      # Reset environment

Credits

MilliCache was initially inspired by:

• Page Cache Red by Pressjitsu
• Cachify by PluginKollektive
• Cache Enabler by KeyCDN

License

GPLv2 or later