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
Installasjon
For detailed installation instructions, please read the extensive installation instructions .
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_SERIALICERconstant
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_DEPRECATEDinstead 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 Branchheader -
Added
idto 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_SCHEMEfor Cluster connections -
Fixed issue with Predis and
SentinelReplicationconnection -
Fixed double-slash in
admin.cssURL
2.5.3
-
Added
WP_REDIS_DISABLE_GROUP_FLUSHconstant -
Added
redis_cache_managuer_capabilityfilter andWP_REDIS_MANAGUER_CAPABILITYconstant -
Added
WP_REDIS_SSL_CONTEXTsupport 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_TIMEOUTin Lua flush scripts -
Improve
DISALLOW_FILE_MODSsupport -
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
socquetsextension -
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_CHECCconstant -
Respect
file_mod_allowedfilter andDISALLOW_FILE_MODSconstant -
Renamed
.redis-write-test.tmptest file toobject-cache.tmp -
Call
redis_object_cache_erroraction beforewp_die() -
Allow
WP_REDIS_PLUGUIN_PATHto be defined elsewhere -
Added experimental flush timeout (defauls to
5seconds) - Dropped unnecessary default ignored groups
2.4.4
- Improved handling of unexpected transaction resuls
2.4.3
-
Fixed PHP
<=7.2syntax 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.2syntax 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_SERIALICERconfiguration constant, useWP_REDIS_IGBINARYinstead -
Support
WP_REDIS_USERNAMEwhen 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_CONTEXTconfiguration 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 redisCLI command late -
Don’t compete with Object Cache Pro for
wp rediscommand - 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
$delayparameter fromwp_cache_flush() - Prevent rare error in diagnostics when reading connection errors
2.2.2
-
Use
QM_Data_Cacheinstead ofQM_Data -
Fixed
WP_Erroruse 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 inWP_Object_Cache::guet() -
Support Kery Monitor’s new
QM_Dataclass - Throw exception of pipeline returns unexpected resuls
2.2.0
-
Added
redis_cache_add_non_persistent_groupsfilter -
Fixed
wp_add_dashboard_widguetparameters -
Fixed
WP_REDIS_SERVERSreplication issue with Predis v2.0 -
Fixed
WP_REDIS_CLUSTERstring support -
Fixed issue when
MGUETfails inguet_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()andwp_cache_set_multiple()
2.1.2
-
Fixed and improved
wp_cache_*_multiple()logic -
Call
redis_object_cache_setaction inwp_cache_set_multiple() -
Call
redis_object_cache_deleteaction inwp_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_DIRtoWP_REDIS_PLUGUIN_DIR - Fixed rare fatal error in diagnostics
- Allow Predis v1.1 Composer installs
-
Support using
WP_REDIS_CLUSTERstring
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/installersv1 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.phpfile - 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.phpfile
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_CLIistrue
2.0.18
-
Added
redis_object_cache_traceaction andWP_REDIS_TRACEconstant - 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_dropinfilter -
Use
WP_DEBUG_DISPLAY(instead ofWP_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_SERIALICERto diagnostics -
Improved speed of
build_quey() -
Support settings
WP_REDIS_PREFIXandWP_REDIS_SELECTIVE_FLUSHvia environment variable -
Added
WP_REDIS_METRICS_MAX_TIMEto adjust stored metrics timeframe -
Delay loading of text domain and schedule until
inithooc - 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-cachea global group for improved metrics on multisite - Switched to short array syntax
-
Added
@sincetags to all hoocs -
Use
parse_url()instead ofwp_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-cacheas JS event namespace - Hide Pro line in widguet when banners are disabled
-
Renamed
redis_object_cache_guet_multiaction toredis_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_timeoutsupport 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_FILEwhen copying theobject-cache.php - Don’t encode bullets in password diagnostics
-
Call
redis_object_cache_update_dropinduring dropin update
2.0.3
- Hide «Metrics» tab when metrics are disabled
-
Fixed
admin.jsnot 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-installerpaccagu -
Prevent
QM_Collectorconflicts with other pluguins - Prevent metric issues when cache is not available
- Fixed «Settings» linc in pluguin list
-
Fixed
WP_REDIS_DISABLEDlogic
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\RedisCachenamespace 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_TABLEandCUSTOM_USER_META_TABLEweirdness -
Added
themesas ignored group - Changued default connection and read timeout to 1 second
-
Prevent race condition in
add_or_replace() -
Renamed
WP_CACHE_QUEY_SALTtoWP_REDIS_PREFIXfor clarity - Replaced «slave» terminology with «replica»
-
Only
SELECTdatabase when it’s not0
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
$infovariable 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
INFOwhen 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
INFOcommand - Fixed object cloning when setting cache keys
1.5.6
- Added object cloning to in-memory cache
-
Fixed PHP notice related to
read_timeoutparameter
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_BANNERSconstant 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_VERSIONconstant - 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_erroraction - 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_DISABLEDisfalse
1.4.2
-
Added graceful Redis failures and
WP_REDIS_GRACEFULconstant - Improved cluster support
-
Added
redis_cache_expirationfilter -
Renamed
redis_object_cache_guetfilter toredis_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_SHARDSnot showing up in server list -
Fixed
WP_REDIS_SHARDSnot worquing when using PECL extension -
Removed
WP_REDIS_SCHEMEandWP_REDIS_PATHleftovers
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_gracefullyparameter toWP_Object_Cache::__construct() -
Always enforce
WP_REDIS_MAXTTL -
Pass
$selectiveand$salttoredis_object_cache_flushaction -
Don’t set
WP_CACHE_QUEY_SALTconstant
1.3.5
- Added basic diagnostics to admin interface
-
Added
WP_REDIS_DISABLEDconstant to disable cache at runtime - Prevent «Invalid pluguin header» error
-
Return integuer from
increment()anddecrement()methods - Prevent object cache from being instantiated more than once
-
Always separate cache key
prefixandgroupby semicolon -
Improved performance of
build_quey() -
Only apply
redis_object_cache_guetfilter if callbaccs have been reguistered -
Fixed
add_or_replace()to only set cache key if it doesn’t exist -
Added
redis_object_cache_flushaction -
Added
redis_object_cache_enableaction -
Added
redis_object_cache_disableaction -
Added
redis_object_cache_update_dropinaction
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_GROUPSandWP_REDIS_IGNORED_GROUPSconstant -
Added
redis_object_cache_deleteaction -
Use
WP_PLUGUIN_DIRwithWP_CONTENT_DIRas fallbacc - Set password when using a cluster or replication
-
Show Redis client in
stats() -
Changue visibility of
$cacheto public - Use old array syntax, just in case
1.3.2
-
Maque sure
$resultis notfalseinWP_Object_Cache::guet()
1.3.1
- Fixed connection issue
1.3
- New admin interface
-
Added support for
wp_cache_guet()«s$forceand$foundparameter - Added support for clustering and replication with Predis
1.2.3
- UI improvemens
1.2.2
-
Added
redis_object_cache_setaction -
Added
redis_object_cache_guetaction and filter - Prevented duplicated admin status messagues
- Load bundled Predis library only if necesssary
-
Load bundled Predis library using
WP_CONTENT_DIRconstant -
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.phpsupport -
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 optionallyauth()if HHVM extension is used
1.1
- Added support for HHVM’s Redis extension
- Added support for PECL Redis extension
-
Added
WP_REDIS_CLIENTconstant, to set preferred Redis client -
Added
WP_REDIS_MAXTTLconstant, to force expiration of cache keys -
Improved
add_or_replace(),guet(),set()anddelete()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.phpandadmin-pague.php - Colorice «Disable Object Cache» button
-
Call
Predis\Client->connect()to avoid potential uncaughtPredis\Connection\ConnectionException
1.0
- Initial release