- Discussions
- 4 646
- Messages
- 12 054
- Solutions
- 81
- J'aime
- 7 609
- Points
- 198
This add-on uses Credis with a custom cache provider for Redis (based off Cm_Cache_Backend_Redis). For best performance, install the php extension: phpredis
Vous devez avoir une instance Redis installée, ce n'est probablement pas possible avec l'hébergement partagé.
You must have a Redis instance installed, this is likely not possible with shared hosting
While XenForo 2 has a redis connector, it requires phpredis. This add-on does not.
Feature overview
Please be aware that Redis is very sensitive to latency in a virtual environment. If repeated connection failures or protocol errors are experienced disable any Redis Persistence options.
Options
By default, forum thread counts are cached. In general, this is observable when moving large number of threads from one forum to another, and the total page counts are wrong.
Redis Statistics
Admincp dash board is extended with basic redis statistics :
FAQ :
xenforo.com
Read Scaling
With the $config['cache']['config']['load_from_slave'] option, reads can be deferred to a singular slave instance. This takes all the options of 'config' (except the slave config)
See the FAQ for configuration samples.
High availability
The Zend component support master/slave setups with Redis Sentinel support. It does not support Redis multi-master clustering.
Components licenced under; New BSD
Please create a GitHub Pull request via the "More Information" link.
Télécharger V2.7.0 : Version 2.7.1 : When using redis-sentinel HA, support 'server' configuration option being an array instead of a comma separated list
Télécharger V2.7.1 : Version 2.7.2 : Fix "Error: Call to a member function save() on null" when a cache is not defined
Télécharger V2.7.2 : Version 2.7.3 bugfix update :
Correctly use 'Small forum threshold' option
Cleanup wording around forum count caching options.
Télécharger V2.7.3 : Version 2.8.0 bugfix update :
Add support for Sentinel AUTH
Add support for multiple statically configured read slaves.
Support displaying multiple redis stats in AdminCP home when multiple 'cache context' are configured.
Télécharger V2.8.0 : Version 2.9.0 - XF2.2 compatibility update :
Requires php 7.0+
Confirmed XF2.2 support
Work-around for non-numeric style ids to css.php causing unexpected fallback to master style which may not have all the required templates
Télécharger V2.9.0 : Version 2.9.1 Compatibility update : php 8 compatibility fix
Télécharger V2.9.1 : Version 2.9.2 - Maintenance update : Extend XF's debugger html output to display redis session stats
Télécharger V2.9.2 : Version 2.9.3 - Maintenance update :
Support using PHP Redis extension for TLS connections when v5.3.0+ is present. Older version will fall back to the pure php implementation for communicating with a redis server
Télécharger V2.9.3 : Version 2.10.0 - Maintenance & Feature update :
Add php7+ type hinting
Add short (per-user) caching for 'user online' widget. On busy forums this may reduce the contention of xf_session_activity table.
Télécharger V2.10.0 : Version 2.10.1 - Bugfix update : Fix debug mode support for php 7.2 and earlier.
Version 2.10.2 - Bugfix update : Fix debug mode support for php 7.2 and earlier. Take 2
Télécharger V2.10.2 : Version 2.10.4 - Bugfix update :
Force global namespace for functions which are known to be optimizable to bytecode in php
Track latest upstream Credis library
Fix "TypeError: Argument 1 passed to XXXX must be of the type YYYY, bool given" when the decompressor library for content stored in redis unexpectedly disappears
Télécharger V2.10.4 : Version 2.10.7 Bugfix & Maintenance update :
Fix email rendering
Prefix known global functions to avoid a current namespace lookup for the function.
Work-around for non-desirable caching behaviour when CloudFlare (or similar) is forced to cache css.php output
If css.php would return empty output instead return a 404 and cache in redis for at most a second
Prevent polluting of caches if the time-stamp is in the future
Improve XF Cloud support
config.php are not required if the stock Redis connector is used.
Currently XF Cloud does not use Redis for the main cache which prevents various redis-only add-ons from functioning as expected
Télécharger V2.10.7 : Version 2.10.8 Bugfix update :
Update library used to talk to redis to version which is confirmed php 8.1 compatible
Improve compatibility with 3rd party add-ons with caching applied to user's online list
Télécharger V2.10.8 : Version 2.10.9 Bugfix update : Fix case where cached forum thread counts may be inaccurate due to insufficiently specific cache key.
Télécharger V2.10.9 : Version 2.10.10 - Bugfix update :
Fix php 8.1+ error with phpredis + socket connections
Workaround for php 8.0.17+/8.1.4+ issue when zlib output compression & serving css
Télécharger V2.10.10 : Version 2.11.0 - Feature update :
Fix support for Redis v7+ high-availability using Redis Sentinel
Add support for redis auth via username/password (vs just password). Requires redis v6+
Improve SSL/TLS support, exposing tls/ssl options.
Télécharger V2.11.0 : Version 2.11.1 Bugfix update :
Fix several php 8.1 compatibility issues with Redis sentinel usage
Fix bad default port for raw IP when connnecting to multiple redis sentinels
Télécharger V2.11.1 : Version 2.11.2 - Bugfix update : Fix possible redis compatibility issue which may result in empty css being returned instead of a 404
Télécharger V2.11.2 : Version 2.11.3 Bugfix & minor feature update :
- Fix "Short Thread Count Expiry time" and "Thread Count Expiry time" options where swapped.
- Support caching item-counts in @Bob's Review Management System.
Télécharger V2.11.3 : Version 2.11.4 - php compatibility update : Initial php 8.2 compatibility update.
Télécharger V2.11.4 : Version 2.11.5 Bugfix update :
- Fix "CredisException: ERR syntax error ", when a non-integer is passed to \XF::app()->cache->save() without php-redis installed. Known to affect Threadmark's rss caching.
Télécharger V2.11.5 : Version 2.12.0 - Maintenance update :
- Track latest upstream Credis library
- Replace "master/slave" terminology with "primary/replica" terminology. Previous config.php setting will still work.
Télécharger V2.12.0 : Version 2.13.0 - Feature update :
This add-on is now available on atelieraphelion.com
Télécharger V2.15.1 : Version 2.15.2 - Maintenance update :
- Display maximum memory and maximum memory policy in admincp redis status information block for troubleshooting purposes.
Télécharger V2.15.2 : Version 2.15.3 - Bugfix update :
Fix helper code to expire/purge redis keys did not support non-main cache backends.
Télécharger V2.16.1 : Version 2.17.0 - XF2.3 Compatibility update
Version 2.17.1 : Fix XF2.3 compatibility when css caching is enabled.
Version 2.17.2 :
- Fix high availability support where css updates would be sent to a possible readonly replica instead of the writable instance.
Télécharger V2.17.2 : Version 2.18.0 - Feature update : Restore XF2.1 support
Télécharger V2.18.0 : Version 2.18.1 - Bugfix update : Fix XF2.3 support for some add-ons depending on extended redis functionality.
Télécharger V2.18.1 : Version 2.18.2 - Bugfix update : Fix
Télécharger V2.18.2 : Version 2.18.3 - Bugfix update :
Vous devez avoir une instance Redis installée, ce n'est probablement pas possible avec l'hébergement partagé.
You must have a Redis instance installed, this is likely not possible with shared hosting
While XenForo 2 has a redis connector, it requires phpredis. This add-on does not.
Feature overview
- A pure php redis connector
- High availability support
- Exposes redis cache object for use for use by other add-ons
- Implements some minor caching of forum thread counts
Please be aware that Redis is very sensitive to latency in a virtual environment. If repeated connection failures or protocol errors are experienced disable any Redis Persistence options.
Options
By default, forum thread counts are cached. In general, this is observable when moving large number of threads from one forum to another, and the total page counts are wrong.
Redis Statistics
Admincp dash board is extended with basic redis statistics :
FAQ :
Redis Cache By Xon - Extra info
xenforo.com
Read Scaling
With the $config['cache']['config']['load_from_slave'] option, reads can be deferred to a singular slave instance. This takes all the options of 'config' (except the slave config)
See the FAQ for configuration samples.
High availability
The Zend component support master/slave setups with Redis Sentinel support. It does not support Redis multi-master clustering.
- Additionally, this add-on implement caching of thread counts in a forum.
- Redis Sentinel support for high-availability (see FAQ for details).
Components licenced under; New BSD
- Credis
- XenForo Add-on code
Please create a GitHub Pull request via the "More Information" link.
Télécharger V2.7.0 : Version 2.7.1 : When using redis-sentinel HA, support 'server' configuration option being an array instead of a comma separated list
Télécharger V2.7.1 : Version 2.7.2 : Fix "Error: Call to a member function save() on null" when a cache is not defined
Télécharger V2.7.2 : Version 2.7.3 bugfix update :
Correctly use 'Small forum threshold' option
Cleanup wording around forum count caching options.
Télécharger V2.7.3 : Version 2.8.0 bugfix update :
Add support for Sentinel AUTH
Add support for multiple statically configured read slaves.
Support displaying multiple redis stats in AdminCP home when multiple 'cache context' are configured.
Télécharger V2.8.0 : Version 2.9.0 - XF2.2 compatibility update :
Requires php 7.0+
Confirmed XF2.2 support
Work-around for non-numeric style ids to css.php causing unexpected fallback to master style which may not have all the required templates
Télécharger V2.9.0 : Version 2.9.1 Compatibility update : php 8 compatibility fix
Télécharger V2.9.1 : Version 2.9.2 - Maintenance update : Extend XF's debugger html output to display redis session stats
Télécharger V2.9.2 : Version 2.9.3 - Maintenance update :
Support using PHP Redis extension for TLS connections when v5.3.0+ is present. Older version will fall back to the pure php implementation for communicating with a redis server
Télécharger V2.9.3 : Version 2.10.0 - Maintenance & Feature update :
Add php7+ type hinting
Add short (per-user) caching for 'user online' widget. On busy forums this may reduce the contention of xf_session_activity table.
Télécharger V2.10.0 : Version 2.10.1 - Bugfix update : Fix debug mode support for php 7.2 and earlier.
Version 2.10.2 - Bugfix update : Fix debug mode support for php 7.2 and earlier. Take 2
Télécharger V2.10.2 : Version 2.10.4 - Bugfix update :
Force global namespace for functions which are known to be optimizable to bytecode in php
Track latest upstream Credis library
Fix "TypeError: Argument 1 passed to XXXX must be of the type YYYY, bool given" when the decompressor library for content stored in redis unexpectedly disappears
Télécharger V2.10.4 : Version 2.10.7 Bugfix & Maintenance update :
Fix email rendering
Prefix known global functions to avoid a current namespace lookup for the function.
Work-around for non-desirable caching behaviour when CloudFlare (or similar) is forced to cache css.php output
If css.php would return empty output instead return a 404 and cache in redis for at most a second
Prevent polluting of caches if the time-stamp is in the future
Improve XF Cloud support
config.php are not required if the stock Redis connector is used.
Currently XF Cloud does not use Redis for the main cache which prevents various redis-only add-ons from functioning as expected
Télécharger V2.10.7 : Version 2.10.8 Bugfix update :
Update library used to talk to redis to version which is confirmed php 8.1 compatible
Improve compatibility with 3rd party add-ons with caching applied to user's online list
Télécharger V2.10.8 : Version 2.10.9 Bugfix update : Fix case where cached forum thread counts may be inaccurate due to insufficiently specific cache key.
Télécharger V2.10.9 : Version 2.10.10 - Bugfix update :
Fix php 8.1+ error with phpredis + socket connections
Workaround for php 8.0.17+/8.1.4+ issue when zlib output compression & serving css
Télécharger V2.10.10 : Version 2.11.0 - Feature update :
Fix support for Redis v7+ high-availability using Redis Sentinel
Add support for redis auth via username/password (vs just password). Requires redis v6+
PHP:
$config['cache']['config']['username'] = 'myUsername'; // requires redis 6+, or for cloud redis installations
$config['cache']['config']['password'] = '....';Improve SSL/TLS support, exposing tls/ssl options.
PHP:
$config['cache']['config']['server'] = 'ssl://127.0.0.1';
// See https://www.php.net/manual/en/context.ssl.php for details
$config['cache']['config']['tlsOptions'] = [
'SNI_enabled' => true,
];Télécharger V2.11.0 : Version 2.11.1 Bugfix update :
Fix several php 8.1 compatibility issues with Redis sentinel usage
Fix bad default port for raw IP when connnecting to multiple redis sentinels
Télécharger V2.11.1 : Version 2.11.2 - Bugfix update : Fix possible redis compatibility issue which may result in empty css being returned instead of a 404
Télécharger V2.11.2 : Version 2.11.3 Bugfix & minor feature update :
- Fix "Short Thread Count Expiry time" and "Thread Count Expiry time" options where swapped.
- Support caching item-counts in @Bob's Review Management System.
Télécharger V2.11.3 : Version 2.11.4 - php compatibility update : Initial php 8.2 compatibility update.
Télécharger V2.11.4 : Version 2.11.5 Bugfix update :
- Fix "CredisException: ERR syntax error ", when a non-integer is passed to \XF::app()->cache->save() without php-redis installed. Known to affect Threadmark's rss caching.
Télécharger V2.11.5 : Version 2.12.0 - Maintenance update :
- Track latest upstream Credis library
- Replace "master/slave" terminology with "primary/replica" terminology. Previous config.php setting will still work.
Télécharger V2.12.0 : Version 2.13.0 - Feature update :
This add-on is now available on atelieraphelion.com
- Require XenForo 2.2+
- Require php 7.2+
- Track latest upstream Credis library
- Fix some errors from Redis would trigger an unhelpful php type error, instead of a more useful error message
- Correctly implement "saveMultiple" method on the cache interface. This method is not used by XenForo (and apparently any other 3rd party).
- Will be using in an upcoming Cache Permission Checks update
- Track latest upstream Credis library
- When various bulk-thread operations happen (move/merge/delete/approve & admincp "Batch update threads"), purge the cached forum totals to avoid stale page navigation entries.
Uses the job queue to avoid blocking the request.
- Remove displaying if Lua is configured or not, and remove the Lua enable/disable option.
- Lua support was first added to redis v2.6.0, and this add-on required redis v3
- Rework caching provider code in preparation for XenForo 2.3
- XF have documented they are switching from Doctrine/Cache to Symfony/Cache
- I have not tested this on XF2.3, and have coded against the public interfaces of the Symfony/Cache package.
- A future release may be required for full XF2.3 compatibility.
Télécharger V2.15.1 : Version 2.15.2 - Maintenance update :
- Display maximum memory and maximum memory policy in admincp redis status information block for troubleshooting purposes.
Télécharger V2.15.2 : Version 2.15.3 - Bugfix update :
- Update credis library
- Fix possible php 8.1 compatibility issue
Fix helper code to expire/purge redis keys did not support non-main cache backends.
- If using a separate caching backend for
css, old styling was not actively expired as expected, resulting in higher memory usage - If 3rd party code uses
expireCacheByPattern/purgeCacheByPatternfunction, the new nullable 'cache' parameter should be used
- High avaliability config default change:
- Change default value for retry_reads_on_primary config option to true as this guards against unexpected replication delays
- Remove unexpected differences for XF2.2 and XF2.3 support (only tested on XF2.2)
- When displaying redis version, include the redis varaint type.
- Known variants are keydb & dragonflydb.
- Dragonflydb does not appear to support IO stats at the moment
- Disable behavior which caused css.php to return a 404 on an invalid template.
- For the old behaviour of returning a HTTP 404 response, set this config.php option :
PHP:
$config['svForce404OnEmptyCss'] = true;Télécharger V2.16.1 : Version 2.17.0 - XF2.3 Compatibility update
- XF2.3 compatibility update
- A bug in XenForo 2.3 Beta 1 (Fixed in beta 2) prevents XenForo from using this as a caching backend without manual code patching references to Adapter\AbstractAdapter to
Adapter\AdapterInterface
- A bug in XenForo 2.3 Beta 1 (Fixed in beta 2) prevents XenForo from using this as a caching backend without manual code patching references to Adapter\AbstractAdapter to
- Add
\SV\RedisCache\Repository\Redis::get()->getRedisConnector()method, this should be used instead of\XF::app()->cache() instanceof Redisor similar.
Version 2.17.1 : Fix XF2.3 compatibility when css caching is enabled.
Version 2.17.2 :
- Fix high availability support where css updates would be sent to a possible readonly replica instead of the writable instance.
Télécharger V2.17.2 : Version 2.18.0 - Feature update : Restore XF2.1 support
Télécharger V2.18.0 : Version 2.18.1 - Bugfix update : Fix XF2.3 support for some add-ons depending on extended redis functionality.
Télécharger V2.18.1 : Version 2.18.2 - Bugfix update : Fix
deleteMultiple() method for XF2.3 (not used by stock XF)Télécharger V2.18.2 : Version 2.18.3 - Bugfix update :
- php 8.4+ compatibility fixes
- For XF2.3.4+, check "View server information" admin permission when viewing redis information
![[xBt] Footer Links 2.2.4](https://www.societyfrenchmodding.net/data/attachments/1/1522-61258a741921565bbf365e1b692931e5.jpg){kind=small}
Pièces jointes
Dernière édition par un modérateur:
