feat: add ddev redis-backend for swappable backends, fixes #32, fixes #28

[stasadev]

The Issue

• Feature: Swappable Redis-Compatible KV stores  #32
• Valkey as additional service - redis alternative #28

How This PR Solves The Issue

Adds ddev redis-backend command.

Manual Testing Instructions

Using Laravel quickstart https://ddev.readthedocs.io/en/stable/users/quickstart/#laravel

mkdir my-laravel-site && cd my-laravel-site
ddev config --project-type=laravel --docroot=public
ddev start
ddev composer create-project laravel/laravel

Get this PR add-on:

ddev dotenv set .env --cache-store=redis --redis-host=redis
ddev add-on get https://github.com/ddev/ddev-redis/tarball/20250424_stasadev_redis_backend
ddev redis-backend redis
ddev restart

Testing redis cache in Laravel:

cat <<'EOF' >routes/web.php
<?php
use Illuminate\Support\Facades\Route;
Route::get('/set/{key}/{value}', function ($key, $value) {
    cache()->set($key, $value);
    echo $value;
});
Route::get('/get/{key}', function ($key) {
    echo cache()->get($key);
});
EOF

$ curl -f https://my-laravel-site.ddev.site/set/foo/bar
bar

$ curl -f https://my-laravel-site.ddev.site/get/foo
bar

And now repeat:

ddev redis-backend redis-alpine
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend valkey
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend valkey-alpine
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend redis:6
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

Do the same with optimized config:

ddev dotenv set .env --cache-store=redis --redis-host=redis --redis-password=redis
ddev add-on get https://github.com/ddev/ddev-redis/tarball/20250424_stasadev_redis_backend
ddev redis-backend redis optimized
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend redis-alpine optimized
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend valkey optimized
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend valkey-alpine optimized
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

ddev redis-backend redis:6 optimized
ddev restart
curl -f https://my-laravel-site.ddev.site/set/bar
curl -f https://my-laravel-site.ddev.site/get

Automated Testing Overview

Release/Deployment Notes

[stasadev]

I did some manual testing, not everything is 100% compatible with redis-server CLI, some images want to accept config with -c config_file.conf, others have completely different options.

This can be overridden with command: in docker-compose.redis_extra.yaml file.

So I'll only use redis and valkey presets, as I don't need to change anything for them.

Manual testings instructions are updated.

[hanoii]

I did try this branch for the add-on and seems to work fine!