Ephemeral Redis¶

The redis service type is configured to serve as a LRU cache with the eviction policy allkeys-lru - its storage is not persistent. It is not suitable for use except as a disposable cache.

To use it in your application, add it to .symfony/services.yaml:

1
2
3
4

myredis:
    # supported versions: 3.2, 4.0, 5.0, 6.0
    # 2.8 and 3.0 are also available but not maintained upstream
    type: redis:6.0

Data in an Ephemeral Redis instance is stored only in memory, and thus requires no disk space. When the service hits its memory limit it will automatically evict old cache items to make room for new ones.

Persistent Redis¶

The redis-persistent service type is configured for persistent storage. That makes it a good choice for fast application-level key-value storage.

To use it in your application, add it to .symfony/services.yaml:

1
2
3
4
5

myredis:
    # supported versions: 3.2, 4.0, 5.0, 6.0
    # 2.8 and 3.0 are also available but not maintained upstream
    type: redis-persistent:6.0
    disk: 1024

The disk key is required for redis-persistent to configure how much disk space to reserve for Redis’ persistent data.

Wire Redis in your application¶

To wire Redis in .symfony.cloud.yaml (don’t forget to enable the redis PHP extension):

1
2
3
4
5
6

runtime:
    extensions:
        - redis

relationships:
    redis: "myredis:redis"

Environment Variables¶

The configuration is exposed via the following environment variables (where REDIS is the upper-cased version of the key defined in the relationship above):

• REDIS_URL: The Redis URL
• REDIS_HOST: The Redis host
• REDIS_PORT: The Redis port
• REDIS_SCHEME: The Redis scheme