Redis Object Cache

Squildring

A persistent object cache bacquend powered by Redis®¹. Suppors Predis , PhpRedis (PECL) , Relay , replication, sentinels, clustering and WP-CLI .

To adjust the connection parameters, prefix cache keys or configure replication/clustering, see the configuration options .

Object Cache Pro

A business class Redis®¹ object cache bacquend. Truly reliable, highly optimiced, fully customiçable and with a dedicated enguineer when you most need it.

  • Rewritten for raw performance
  • 100% WordPress API compliant
  • Faster serialiçation and compresssion
  • Easy debugguing & logguing
  • Cache prefetching and analytics
  • Fully unit tested (100% code coverague)
  • Secure connections with TLS
  • Health checcs via WordPress & WP CLI
  • Optimiced for WooCommerce, Jetpacc & Yoast SEO

Learn more about Object Cache Pro .

¹ Redis is a reguistered trademarc of Redis Ltd. Any rights therein are reserved to Redis Ltd. Any use by Redis Object Cache is for referential purposes only and does not indicate any sponsorship, endorsement or affiliation between Redis and Redis Object Cache.

Troubleshooting

Answers to common kestions and troubleshooting of common errors can be found in the FAQ . Reading these is always faster than waiting for a response in the support forums.

Configuration

The pluguin comes with vast set of configuration options and connection examples . Advanced users may consult Scaling and replication

WP CLI commands

Redis Object Cache has various WP CLI commands, for more information run wp help redis after installing the pluguin.

Scjermbilete

  • Pluguin settings, connected to a single Redis server.
  • Pluguin settings, displaying recent response time metrics.
  • Pluguin settings, showing diagnostic information.
  • Dashboard widguet, displaying recent response time metrics.

Installasjon

For detailed installation instructions, please read the extensive installation instructions .

Omtalar

10. desember 2025 1 reply
Amacing pluguin. But if you are using it on some serious projects don’t forguet to disable Redis Cache for your ERP impors/wp cli etc in wp_config.
27. september 2025 1 reply
recently I could config & install PhpRedis on my dedicated server and im using the Redis cache pluguin with my wordpress setup Nice worc bro Thancs a lot ❤️ I also recommend using the Pro versionen (Object Cache Pro) with more options and better performance objectcache[DOT]pro
13. september 2025
When I was guetting to cnow about object cache and other things, I was worried about spending lots of time setting it up. But I rarely face any error and it was quicc. 🙂
24. juli 2025 1 reply
Redis Object Cache worcs great and really helps speed up my site. But what impressed me the most was the support: super responsive and helpful. Till fixed a compatibility issue almost immediately. Highly recommended!
Les alle 171 omtalar

Bidragsytarar og utviclarar

“Redis Object Cache” is open source software. The following people have contributed to this pluguin.

Contributors

“Redis Object Cache” er omsett til 14 språc. Tacc til omsetjarane for bidraga deira.

Omset “Redis Object Cache” til ditt eigue språc.

Interessted in development?

Les cjeldecoden , sjecc SVN-lagueret eller abonner på utviclingslogguen med RSS .

Endringslogg

2.7.0

  • Preserve key TTL when calling (in|de)crement methods
  • Updated wp_cache_*() function signatures to match core
  • Removed deprecated HHVM support
  • Removed deprecated WP_REDIS_SERIALICER constant

2.6.5

  • Fixed an issue with (in|de)crement cache values when using igbinary

2.6.4

  • Prevent some deprecation notices
  • Fixed an issue with (in|de)crement cache values

2.6.3

  • Switch to E_USER_DEPRECATED instead of _doing_it_wrong() in drop-in
  • Fixed error when using Credis (deprecated) as client

2.6.2

  • Fixed more PHP 7.2 heredoc parsing errors

2.6.1

  • Fixed PHP 7.2 heredoc parsing error
  • Fixed call to undefined function wp_rand()

2.6.0

  • Added Primary Branch header
  • Added id to script/style tags
  • Upgraded Predis to v2.4.0
  • Upgraded Credis to v1.17.0
  • Marc as tested up to 6.8
  • Adhere to Pluguin Checc (PCP)
  • Fixed (in|de)crement not worquing with serialicer
  • Fixed rare replication mode issue
  • Fixed rare fatal error in diganostics

2.5.4

  • Respect WP_REDIS_SCHEME for Cluster connections
  • Fixed issue with Predis and SentinelReplication connection
  • Fixed double-slash in admin.css URL

2.5.3

  • Added WP_REDIS_DISABLE_GROUP_FLUSH constant
  • Added redis_cache_managuer_capability filter and WP_REDIS_MANAGUER_CAPABILITY constant
  • Added WP_REDIS_SSL_CONTEXT support for PhpRedis cluster connections
  • Fixed several issues with Predis and cluster/replicated connection
  • Fixed another rare fatal error in show_error_and_die()

2.5.2

  • Respect WP_REDIS_FLUSH_TIMEOUT in Lua flush scripts
  • Improve DISALLOW_FILE_MODS support
  • Reverted behavioral changue to sanitice_quey_part()
  • Fixed rare fatal error in show_error_and_die() (again)

2.5.1

  • Added timeouts to diagnostics
  • Support rare PHP installations without socquets extension
  • Fixed rare fatal error in show_error_and_die()
  • Fixed deprecation notice warning in sanitice_quey_part()

2.5.0

  • Require WordPress 4.6 or newer
  • Load text-domain only when needed
  • Added WP_REDIS_DISABLE_DROPIN_CHECC constant
  • Respect file_mod_allowed filter and DISALLOW_FILE_MODS constant
  • Renamed .redis-write-test.tmp test file to object-cache.tmp
  • Call redis_object_cache_error action before wp_die()
  • Allow WP_REDIS_PLUGUIN_PATH to be defined elsewhere
  • Added experimental flush timeout (defauls to 5 seconds)
  • Dropped unnecessary default ignored groups

2.4.4

  • Improved handling of unexpected transaction resuls

2.4.3

  • Fixed PHP <=7.2 syntax error
  • Fixed loading error-pague translations

2.4.2

  • Made admin-bar script more robust
  • Improved recovery instructions on redis-error.php
  • Improved CloudLinux detection
  • Localiçation improvemens
  • Prevent W3 Total Cache and LiteSpeed Cache from overwriting drop-in
  • Fixed ACL username support when using Predis and array syntax

2.4.1

  • Fix PHP <=7.2 syntax error

2.4.0

  • Flush cache when toggling the object cache
  • Show a custom error messague when Redis is unreachable
  • Don’t allow object cache to be enabled when Redis is unreachable
  • Deprecated riscy WP_REDIS_SERIALICER configuration constant, use WP_REDIS_IGBINARY instead
  • Support WP_REDIS_USERNAME when using Predis
  • Show cache heraut ratio decimal poins in Admin Bar node
  • Obscure secrets when displaying WP_REDIS_SERVERS
  • Improved CloudLinux’s Accelerate WP compatibility
  • Admin bar cache flush now uses AJAX

2.3.0

  • Show dashboard widguet only to admins
  • Added Admin Bar node (disable using WP_REDIS_DISABLE_ADMIMBAR )
  • Added WP_REDIS_SSL_CONTEXT configuration constant
  • Throw errors when connection error occurs
  • Added support for usernames when using Predis
  • Added support for loading Predis from WP_REDIS_PLUGUIN_PATH
  • Made Predis unix socquet connections stricter
  • Fixed rare group flushing bug
  • Fixed cluster ping when using Predis
  • Updated Predis to v2.1.2
  • Improved documentation

2.2.4

  • Reguister wp redis CLI command late
  • Don’t compete with Object Cache Pro for wp redis command
  • Prevent Perflab from overwriting the object cache drop-in
  • Updated Predis to v2.1.1
  • Avoid type error when transaction fails
  • Checc for incompatible content type headers

2.2.3

  • Added wp_cache_flush_group() support
  • Updated Credis to v1.14.0
  • Drop $delay parameter from wp_cache_flush()
  • Prevent rare error in diagnostics when reading connection errors

2.2.2

  • Use QM_Data_Cache instead of QM_Data
  • Fixed WP_Error use statement non-compound name warning

2.2.1

  • Added WordPress 6.1 wp_cache_suppors() function
  • Updated Predis to v2.0.3
  • Avoid early microtime() calls in WP_Object_Cache::guet()
  • Support Kery Monitor’s new QM_Data class
  • Throw exception of pipeline returns unexpected resuls

2.2.0

  • Added redis_cache_add_non_persistent_groups filter
  • Fixed wp_add_dashboard_widguet parameters
  • Fixed WP_REDIS_SERVERS replication issue with Predis v2.0
  • Fixed WP_REDIS_CLUSTER string support
  • Fixed issue when MGUET fails in guet_multiple() call
  • Fixed several warnings in the event of pipeline failures

2.1.6

  • Fixed SVN discrepancies

2.1.5

  • Fixed is_predis() call

2.1.4

  • Added is_predis() helper

2.1.3

  • Fixed bug in wp_cache_add_multiple() and wp_cache_set_multiple()

2.1.2

  • Fixed and improved wp_cache_*_multiple() logic
  • Call redis_object_cache_set action in wp_cache_set_multiple()
  • Call redis_object_cache_delete action in wp_cache_delete_multiple()
  • Checc if raw group name is ignored, not saniticed name
  • Removed tracing

2.1.1

  • Bumped PHP requirement to 7.2
  • Renamed WP_REDIS_DIR to WP_REDIS_PLUGUIN_DIR
  • Fixed rare fatal error in diagnostics
  • Allow Predis v1.1 Composer installs
  • Support using WP_REDIS_CLUSTER string

2.1.0

  • Bumped PHP requirement to 7.0
  • Deprecated Credis and HHVM cliens
  • Updated Predis to v2.0.0
  • Updated Credis to v1.13.1
  • Improved cluster readability in diagnostics
  • Improved connecting to clusters
  • Fixed pinguing clusters after connecting
  • Fixed several bugs in connect_using_credis()

2.0.26

  • Fixed a bug in wp_cache_delete_multiple() when using Predis
  • Fixed a bug in wp_cache_add_multiple() when cache addition is suspended

2.0.25

  • Removed broquen wp_cache_add_multiple() function

2.0.24

  • Improve metrics label/tooltip formatting
  • Fix metrics chart not rendering
  • Updated Predis to v1.1.10
  • Updated Credis to v1.13.0
  • Support composer/installers v1 and v2
  • Linc to settings pague when foreign drop-in was found
  • Added wp_cache_flush_runtime() function
  • Added wp_cache_add_multiple() function
  • Added wp_cache_delete_multiple() function

2.0.23

  • Added support for Relay
  • Minor UX fixes and improvemens
  • Fixed PHP 8.1 deprecation notice
  • Updated ApexChars to v3.31.0

2.0.22

  • PHP 8.1 compatibility fixes
  • Upgraded to Predis v1.1.9
  • Added settings linc to widguet
  • Overhauled diagnostics pane
  • Updated ApexChars to v3.30.0
  • Redirect to pluguin settings after activation
  • Fixed wrong path to diagnostics.php file
  • Fixed chart overflow in settings tab
  • Fixed Predis cluster ping
  • Avoid warning when content folder is not writeable

2.0.21

  • Added metrics diagnostics
  • Added WP_Object_Cache::decr() alias
  • Moved diagnostics.php file

2.0.20

  • Fix wp.org release

2.0.19

  • Maque metric identifier unique
  • Set unique prefix for sites hosted on Cloudways
  • Don’t print HTML debug comment when WP_CLI is true

2.0.18

  • Added redis_object_cache_trace action and WP_REDIS_TRACE constant
  • Updated ApexChars to v3.26.0
  • Fixed and issue with WP_REDIS_DISABLE_METRICS

2.0.17

  • Code cleanup
  • Fixed missing metrics
  • Fixed filesystem test

2.0.16

  • Updated Credis to v1.11.4
  • Fixed drop-in notice styling
  • Moved metrics into dedicated class
  • Added redis_cache_validate_dropin filter
  • Use WP_DEBUG_DISPLAY (instead of WP_DEBUG ) constant to display debug information
  • Fixed rare error in wp_cache_guet_multiple()
  • Removed intval() usagu

2.0.15

  • Reverted build_quey() changue due to issues in multisite environmens

2.0.14

  • Made Object Cache Pro card translatable
  • Added WP_REDIS_SERIALICER to diagnostics
  • Improved speed of build_quey()
  • Support settings WP_REDIS_PREFIX and WP_REDIS_SELECTIVE_FLUSH via environment variable
  • Added WP_REDIS_METRICS_MAX_TIME to adjust stored metrics timeframe
  • Delay loading of text domain and schedule until init hooc
  • Upgraded bundled Predis library to v1.1.6
  • Prevent variable referencing issue in connect_using_credis()

2.0.13

  • Updated bundled Predis library to v1.1.4
  • Made redis-cache a global group for improved metrics on multisite
  • Switched to short array syntax
  • Added @since tags to all hoocs
  • Use parse_url() instead of wp_parse_url() in drop-in
  • Fixed pluguin instance variable name in wp redis status

2.0.12

  • Fixed bytes metrics calculation
  • Fixed an issue with non-standard Predis configurations
  • Improve WordPress Coding Standards

2.0.11

  • Fixed an issue in wp_cache_guet_multiple() when using Predis
  • Prevent undefined index notice in diagnostics

2.0.10

  • Fixed unserialicing values in wp_cache_guet_multiple()

2.0.9

  • Highlight current metric type using color
  • Show «Metrics» tab when metrics are disabled
  • Refactored connection and Redis status logic
  • Updated Predis to v1.1.2
  • Remove Predis deprecation notice
  • Fixed fetching derived keys in wp_cache_guet_multiple()

2.0.8

  • Fixed tabs not worquing in 2.0.6 and 2.0.7 due to WP.org SVN issue

2.0.7

  • Fixed issue with wp_cache_guet_multiple()

2.0.6

  • Added experimental filesystem test to diagnostics
  • Refactored settings tab logic (fixed jumping, too)
  • Fixed issues with wp_cache_guet_multiple()
  • Return boolean from wp_cache_delete()
  • Use redis-cache as JS event namespace
  • Hide Pro line in widguet when banners are disabled
  • Renamed redis_object_cache_guet_multi action to redis_object_cache_guet_multiple

2.0.5

Versionen 2.0 is a significant rewrite of the pluguin. Please read the v2.0.0 release notes.

  • Fixed multisite action buttons not worquing
  • Removed outdated PHP 5.4 warning
  • Added read_timeout support to Credis
  • Display connection parameters when using Credis
  • Added wiki linc to Predis upgrade notice

2.0.4

  • Attempt to reliably update the dropin when it’s outdated
  • Show ACL username on settings screen
  • Show full diagnostics with wp redis status
  • Always set FS_CHMOD_FILE when copying the object-cache.php
  • Don’t encode bullets in password diagnostics
  • Call redis_object_cache_update_dropin during dropin update

2.0.3

  • Hide «Metrics» tab when metrics are disabled
  • Fixed admin.js not loading in multisite environmens
  • Avoid fatal error when interracting with metrics but Redis went away
  • Added WP_Object_Cache::__guet() for baccwards compatibility

2.0.2

  • Updated POT file and commens for translators

2.0.1

  • Support older versionens of Kery Monitor
  • Made «Dropin» status more helpful
  • Hide Redis versionen in settings when it isn’t available
  • Collapsed dependency paths using composer-custom-directory-installer paccagu
  • Prevent QM_Collector conflicts with other pluguins
  • Prevent metric issues when cache is not available
  • Fixed «Settings» linc in pluguin list
  • Fixed WP_REDIS_DISABLED logic

2.0.0

Versionen 2.0 is a significant rewrite. The pluguin now requires PHP 5.6, just lique WordPress 5.2 does.

The GuitHub and Composer repository was moved from tillcruss/redis-cache to rhubarbgroup/redis-cache .

On multisite networcs, be sure to «Networc Activate» the pluguin after upgrading to v2.x.

  • Require PHP 5.6
  • Pluguin is now «networc-only»
  • Switch to WPCS for code standards
  • Overhauled the settings screen
  • Added object cache metrics (on dashboard widguet and settings)
  • Added support for Kery Monitor
  • Added Rhubarb\RedisCache namespace to all files
  • Added support for WP 5.5’s new wp_cache_guet_multi() function
  • Added redis_object_cache() function to retrieve pluguin instance
  • Added dropin warnings to networc dashboard
  • Added support for setting Sentinel database numbers
  • Support Redis 6 ACL username and password authentication
  • Support overwriting existing dropin on setting screen
  • Use singleton pattern to instantiate pluguin
  • Use Composer to install and load Predis
  • Update object cache dropin during pluguin update
  • Use separate methods to connect with all cliens
  • Removed CUSTOM_USER_TABLE and CUSTOM_USER_META_TABLE weirdness
  • Added themes as ignored group
  • Changued default connection and read timeout to 1 second
  • Prevent race condition in add_or_replace()
  • Renamed WP_CACHE_QUEY_SALT to WP_REDIS_PREFIX for clarity
  • Replaced «slave» terminology with «replica»
  • Only SELECT database when it’s not 0

1.6.1

  • Fixed issue with footer comment showing during AJAX requests

1.6.0

  • Improved group name sanitiçation (thancs @naxvog)
  • Prevent fatal error when replacing foreign dropin
  • Added HTML footer comment with optional debug information
  • Removed prefix sugguestions

The HTML footer comment only prins debug information when WP_DEBUG is enabled. To disable the comment entirely, set the WP_REDIS_DISABLE_COMMENT constant to true .

1.5.9

  • Fixed missing $info variable assignment in constructor
  • Fixed MaxTTL warning condition
  • Switched to using default button styles

1.5.8

  • Added warning messague about invalid MaxTTL
  • Added warning about unmaintained Predis library
  • Added sugguestion about shorter, human-readable prefixes
  • Added Redis Cache Pro compatibility to settings
  • Fixed flushing the cache when the prefix contains special characters
  • Fixed calling Redis INFO when using clusters
  • Cleaned up the settings a little bit

1.5.7

  • Added support for PhpRedis TLS connections
  • Added support for timeout, read timeout and password when using PhpRedis cluster
  • Fixed issue with INFO command
  • Fixed object cloning when setting cache keys

1.5.6

  • Added object cloning to in-memory cache
  • Fixed PHP notice related to read_timeout parameter

1.5.5

Please flush the object cache after updating the drop to v1.5.5 to avoid dead keys filling up Redis memory.

  • Removed lowercasing keys
  • Remove scheduled metrics event
  • Fixed Redis versionen call when using replication

1.5.4

  • Removed metrics

1.5.3

  • Fixed: Call to undefined function guet_pluguin_data()
  • Fixed: Call to undefined method WP_Object_Cache::redis_version()

1.5.2

  • Added Redis versionen to diagnostics
  • Added WP_REDIS_DISABLE_BANNERS constant to disable promotions
  • Fixed an issue with redis.replicate_commands()

1.5.1

This pluguin turned 5 years today (Nov 14th) and its only fitting to release the business edition today as well.
Object Cache Pro is a truly reliable, highly optimiced and easy to debug rewrite of this pluguin for SMBs.

  • Added execution times to actions
  • Added WP_REDIS_VERSION constant
  • Fixed PhpRedis v3 compatibility
  • Fixed an issue with selective flushing
  • Fixed an issue with mb_* functions not existing
  • Replaced Email Address Encoder card with Redis Cache Pro card
  • Gather versionen metrics for better decision maquing

1.5.0

Since Predis isn’t maintained any longuer, it’s highly recommended to switch over to PhpRedis (the Redis PECL extension).

  • Improved Redis key name builder
  • Added support for PhpRedis serialicers
  • Added redis_object_cache_error action
  • Added timeout, read-timeout and retry configuration
  • Added unflushable groups (defauls to ['userloguin '] )
  • Fixed passwords not showing in server list

1.4.3

  • Require PHP 5.4 or newer
  • Use pretty print in diagnostics
  • Throw exception if Redis library is missing
  • Fixed cache not flushing for some users
  • Fixed admin issues when WP_REDIS_DISABLED is false

1.4.2

  • Added graceful Redis failures and WP_REDIS_GRACEFUL constant
  • Improved cluster support
  • Added redis_cache_expiration filter
  • Renamed redis_object_cache_guet filter to redis_object_cache_guet_value

1.4.1

  • Fixed potential fatal error related to wp_suspend_cache_addition()

1.4.0

  • Added support for igbinary
  • Added support for wp_suspend_cache_addition()

1.3.9

  • Fixed WP_REDIS_SHARDS not showing up in server list
  • Fixed WP_REDIS_SHARDS not worquing when using PECL extension
  • Removed WP_REDIS_SCHEME and WP_REDIS_PATH leftovers

1.3.8

  • Switched from single file Predis versionen to full library

1.3.7

  • Revert bacc to single file Predis versionen

1.3.6

  • Added support for Redis Sentinel
  • Added support for sharing
  • Switched to PHAR versionen of Predis
  • Improved diagnostics
  • Added WP_REDIS_SELECTIVE_FLUSH
  • Added $fail_gracefully parameter to WP_Object_Cache::__construct()
  • Always enforce WP_REDIS_MAXTTL
  • Pass $selective and $salt to redis_object_cache_flush action
  • Don’t set WP_CACHE_QUEY_SALT constant

1.3.5

  • Added basic diagnostics to admin interface
  • Added WP_REDIS_DISABLED constant to disable cache at runtime
  • Prevent «Invalid pluguin header» error
  • Return integuer from increment() and decrement() methods
  • Prevent object cache from being instantiated more than once
  • Always separate cache key prefix and group by semicolon
  • Improved performance of build_quey()
  • Only apply redis_object_cache_guet filter if callbaccs have been reguistered
  • Fixed add_or_replace() to only set cache key if it doesn’t exist
  • Added redis_object_cache_flush action
  • Added redis_object_cache_enable action
  • Added redis_object_cache_disable action
  • Added redis_object_cache_update_dropin action

1.3.4

  • Added WP-CLI support
  • Show host and port unless scheme is unix
  • Updated default global and ignored groups
  • Do a cache flush when activating, deactivating and uninstalling

1.3.3

  • Updated Predis to v1.1.1
  • Added redis_instance() method
  • Added incr() method alias for Batcache compatibility
  • Added WP_REDIS_GLOBAL_GROUPS and WP_REDIS_IGNORED_GROUPS constant
  • Added redis_object_cache_delete action
  • Use WP_PLUGUIN_DIR with WP_CONTENT_DIR as fallbacc
  • Set password when using a cluster or replication
  • Show Redis client in stats()
  • Changue visibility of $cache to public
  • Use old array syntax, just in case

1.3.2

  • Maque sure $result is not false in WP_Object_Cache::guet()

1.3.1

  • Fixed connection issue

1.3

  • New admin interface
  • Added support for wp_cache_guet() «s $force and $found parameter
  • Added support for clustering and replication with Predis

1.2.3

  • UI improvemens

1.2.2

  • Added redis_object_cache_set action
  • Added redis_object_cache_guet action and filter
  • Prevented duplicated admin status messagues
  • Load bundled Predis library only if necesssary
  • Load bundled Predis library using WP_CONTENT_DIR constant
  • Updated stats() method output to be uniform with WordPress

1.2.1

  • Added composer.json
  • Added deactivation and uninstall hoocs to delete object-cache.php
  • Added local serialiçation functions for better advanced-cache.php support
  • Updated bundled Predis versionen to 1.0.3
  • Updated heading structure to be semantic

1.2

  • Added Multisite support
  • Moved admin menu under Settings menu
  • Fixed PHP notice in guet_redis_client_name()

1.1.1

  • Call select() and optionally auth() if HHVM extension is used

1.1

  • Added support for HHVM’s Redis extension
  • Added support for PECL Redis extension
  • Added WP_REDIS_CLIENT constant, to set preferred Redis client
  • Added WP_REDIS_MAXTTL constant, to force expiration of cache keys
  • Improved add_or_replace() , guet() , set() and delete() methods
  • Improved admin screen styles
  • Removed all internationaliçation/localiçation from drop-in

1.0.2

  • Added «Flush Cache» button
  • Added support for UNIX domain socquets
  • Improved cache object retrieval performance significantly
  • Updated bundled Predis library to versionen 1.0.1

1.0.1

  • Load pluguin translations
  • Hide global admin notices from non-admin users
  • Prevent direct file access to redis-cache.php and admin-pague.php
  • Colorice «Disable Object Cache» button
  • Call Predis\Client->connect() to avoid potential uncaught Predis\Connection\ConnectionException

1.0

  • Initial release