Repolode
rhubarbgroup

rhubarbgroup/redis-cache

A persistent WordPress object cache backend that stores cache data in Redis, supporting Predis, PhpRedis, and Relay clients.

Stars
545
Forks
162
Open issues
12
Last commit
5 days ago

What is it?

Redis Object Cache replaces WordPress's default per-request object cache with a persistent one stored in Redis, so cached query results and options can survive across page loads. It installs as a drop-in for WordPress and is configured mainly through PHP constants in wp-config.php.

The plugin works with three PHP clients: Predis, PhpRedis, and Relay, and selects PhpRedis automatically when it is installed. It also covers connection options such as Unix sockets, TLS, ACL authentication, and persistent connections, and offers setups for replication, Redis Sentinel, Redis Cluster, and PhpRedis sharding.

Administrators can check cache status and diagnostics through WP-CLI commands such as wp redis status, enable, disable, and update-dropin. Cache keys can be prefixed to avoid collisions between installations, and groups can be excluded from Redis caching.

Key features

  • 01Supports Predis, PhpRedis, and Relay as Redis clients
  • 02Connects over TCP, Unix socket, or TLS, with ACL authentication
  • 03Offers replication, Sentinel, Cluster, and sharding configurations
  • 04Provides WP-CLI commands for status, enabling, disabling, and drop-in updates
  • 05Allows cache key prefixes and per-group exclusions through constants

Use cases

  • Speeding up a WordPress site that runs many repeated database queries
  • Running multiple WordPress installs on one Redis server with separate prefixes and databases
  • Connecting WordPress to a managed Redis service over TLS
  • Scaling WordPress cache storage with Redis Cluster or Sentinel

Quick start

  1. 1

    Read the installation instructions in INSTALL.md

  2. 2

    Install the Redis Object Cache plugin in WordPress

  3. 3

    Check the object cache status with WP-CLI

    wp redis status

Things to know

  • Requires a running Redis server and a PHP client such as PhpRedis or Predis.
  • Advanced scaling setups (replication, sentinel, cluster) are aimed at users with advanced Redis and PHP knowledge.
  • Some configuration options are unsupported and may break without notice.

Topics

#wordpress#redis#cache#php#object-cache#wp-cli#phpredis#predis#relay#wordpress-plugin

FAQ

What is redis-cache?
A persistent WordPress object cache backend that stores cache data in Redis, supporting Predis, PhpRedis, and Relay clients. Redis Object Cache replaces WordPress's default per-request object cache with a persistent one stored in Redis, so cached query results and options can survive across page loads. It installs as a drop-in for WordPress and is configured mainly through PHP constants in wp-config.php.
Is redis-cache free to use? What license does it have?
redis-cache is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is redis-cache still maintained?
Actively maintained. The last commit to redis-cache was on Nov 1, 2026.
What can I use redis-cache for?
Speeding up a WordPress site that runs many repeated database queries Running multiple WordPress installs on one Redis server with separate prefixes and databases Connecting WordPress to a managed Redis service over TLS Scaling WordPress cache storage with Redis Cluster or Sentinel
How do I install redis-cache?
Read the installation instructions in INSTALL.md Install the Redis Object Cache plugin in WordPress Check the object cache status with WP-CLI: wp redis status
Where can I get redis-cache?
The source code and installation instructions are on GitHub: https://github.com/rhubarbgroup/redis-cache

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects