Redis Object Caching Configuration Guide

Introduction to Redis Object Caching

Redis is a powerful in-memory data store that can be utilized for object caching to significantly enhance the performance of your WordPress and WooCommerce sites. By storing frequently accessed data in memory, Redis reduces database queries and dramatically improves response times.

Prerequisites

Step 1: Installing Redis Server

1Update Package List

First, update your system's package list to ensure you're installing the latest version:

sudo apt update

2Upgrade Existing Packages (Optional)

If there are packages available for upgrade, you can update them:

sudo apt upgrade

3Install Redis Server and PHP Extension

Install both Redis server and the PHP Redis extension in a single command:

sudo apt install redis-server php8.3-redis

4Verify Redis Installation

Check the status of the Redis server service to ensure it's running:

sudo systemctl status redis-server

Step 2: Troubleshooting Redis Installation

5Check Redis Log Files

Examine the Redis log file for any errors or warnings:

sudo cat /var/log/redis/redis-server.log

6Fix Memory Overcommit Warning

If you see a warning about "overcommit_memory is set to 0", you need to fix this issue:

Navigate to the sysctl configuration directory:

cd /etc/sysctl.d/

Create a new configuration file for Redis:

sudo nano 11-redis.conf

Add the following directive to the file:

vm.overcommit_memory = 1

7Reboot the Server

To apply the new configuration, reboot your server:

sudo reboot

8Verify the Fix

After rebooting, check the Redis service status again:

sudo systemctl status redis-server

And check the log file to confirm the warning is resolved:

sudo cat /var/log/redis/redis-server.log

Step 3: Configuring Redis Server

9Locate Redis Configuration

The main Redis configuration file is located in the /etc/redis/ directory:

ls -l /etc/redis/

10Create Backup

Before making changes, create a backup of the original configuration file:

sudo cp /etc/redis/redis.conf /etc/redis/redis.conf.back

11Edit Redis Configuration

Open the Redis configuration file:

sudo nano /etc/redis/redis.conf

12Configure Maximum Memory

Search for the maxmemory directive (press Ctrl+W in nano and type "maxmemory"):

# maxmemory <bytes>

maxmemory 256mb

13Configure Cache Eviction Policy

Below the maxmemory setting, find and configure the eviction policy:

# maxmemory-policy noeviction

maxmemory-policy allkeys-lru

14Restart Redis Service

Apply the new configuration by restarting Redis:

sudo systemctl restart redis-server

Step 4: WordPress Configuration

15Navigate to Site Directory

Change to your WordPress site's document root:

cd /var/www/example.com/public_html/

16Edit wp-config.php

Open the WordPress configuration file:

sudo nano wp-config.php

17Add Cache Key Salt

Scroll down to the WordPress salt section and add the following directive:

define('WP_CACHE_KEY_SALT', 'example.com');

Example Configuration Location

/* Authentication Unique Keys and Salts */
define('AUTH_KEY',         'put your unique phrase here');
define('SECURE_AUTH_KEY',  'put your unique phrase here');
define('LOGGED_IN_KEY',    'put your unique phrase here');
define('NONCE_KEY',        'put your unique phrase here');
define('AUTH_SALT',        'put your unique phrase here');
define('SECURE_AUTH_SALT', 'put your unique phrase here');
define('LOGGED_IN_SALT',   'put your unique phrase here');
define('NONCE_SALT',       'put your unique phrase here');

/* Redis Object Cache Configuration */
define('WP_CACHE_KEY_SALT', 'example.com');

18Save and Reload PHP-FPM

After saving the wp-config.php file, reload the PHP-FPM service:

sudo systemctl reload php8.3-fpm

Step 5: WooCommerce Considerations

19Prevent Redis Caching of WooCommerce Sessions

Add the following directive to your wp-config.php file:

define('WP_REDIS_IGNORED_GROUPS', 'wc_session');

Complete WooCommerce Configuration Example

/* Redis Object Cache Configuration */
define('WP_CACHE_KEY_SALT', 'example.com');

/* Prevent Redis Caching WooCommerce Session Data */
define('WP_REDIS_IGNORED_GROUPS', 'wc_session');

WooCommerce Pages to Exclude from Caching

WooCommerce Cookies to Exclude

• woocommerce_cart_hash
• woocommerce_items_in_cart
• wp_woocommerce_session_*
• woocommerce_recently_viewed
• store_notice[notice_id]
• _wc_session_*

Step 6: Installing Redis WordPress Plugin

Recommended Plugins Based on Caching Strategy

Installing Redis Object Cache Plugin

1. Log in to your WordPress admin dashboard
2. Navigate to Plugins → Add New
3. Search for "Redis Object Cache"
4. Install and activate the plugin by Till Krüss
5. Go to Settings → Redis
6. Click "Enable Object Cache"

Configuring W3 Total Cache for Redis

If using W3 Total Cache, Redis support is built-in:

1. Go to Performance → General Settings
2. Enable "Object Cache" and select "Redis" as the method
3. Configure Redis server settings (usually localhost:6379)
4. Save settings and clear all caches

Step 7: Testing and Verification

20Verify Redis Connection

Check if Redis is accepting connections:

redis-cli ping

21Monitor Redis Statistics

View Redis statistics and information:

redis-cli info stats

22Check Cache Keys

View all cached keys (use cautiously on production):

redis-cli keys '*'

23Monitor Memory Usage

Check Redis memory consumption:

redis-cli info memory

Performance Testing

Step 8: Maintenance and Monitoring

Flushing Redis Cache

To clear all cached data from Redis:

redis-cli flushall

Monitoring Redis Performance

View real-time Redis commands:

redis-cli monitor

Check slow queries:

redis-cli slowlog get 10

Regular Maintenance Tasks

Troubleshooting Common Issues

Issue 1: Redis Not Starting

Issue 2: WordPress Not Connecting to Redis

Issue 3: Poor Cache Performance

Issue 4: High Memory Usage

Best Practices and Recommendations

Multi-Site Configuration

Security Considerations

Quick Reference Summary

sudo apt update
sudo apt install redis-server php8.3-redis

sudo nano /etc/sysctl.d/11-redis.conf
# Add: vm.overcommit_memory = 1
sudo reboot

sudo nano /etc/redis/redis.conf
# Set: maxmemory 256mb
# Set: maxmemory-policy allkeys-lru
sudo systemctl restart redis-server

sudo nano /var/www/example.com/public_html/wp-config.php
# Add: define('WP_CACHE_KEY_SALT', 'example.com');
# Add: define('WP_REDIS_IGNORED_GROUPS', 'wc_session');
sudo systemctl reload php8.3-fpm

Essential Commands Quick Reference

Conclusion

Redis object caching is a powerful tool for enhancing WordPress and WooCommerce performance. By following this comprehensive guide, you have successfully:

• Installed and configured Redis server on your Ubuntu system
• Resolved common installation issues and warnings
• Optimized Redis for WordPress object caching
• Configured WordPress to utilize Redis caching
• Implemented WooCommerce-specific considerations
• Set up monitoring and maintenance procedures