Wikilivres

Programmation PHP/Redis

< Programmation PHP
Memcached Memcached
Formulaire Formulaire

[ Modifier le sommaire ]

Memcached Memcached
Formulaire Formulaire


InstallationModifier

Redis est comme Memcached, un système de gestion de base de données clef-valeur scalable, très hautes performances. En 2019, il devient plus utilisé que Memcached car il possède plus de fonctionnalités[1]. Par exemple il permet en plus une persistance sur la mémoire morte utile pour les reprises sur panne, autoriser les groupes de paires clé-valeur, et gère mieux le parallélisme[2].

Pour l'installer : 

 sudo apt-get install redis-server

Obtenir la version : 

redis-server -v
Redis server v=6.2.5 sha=00000000:0 malloc=jemalloc-5.1.0 bits=64 build=19d2f4c94e0b6820

ClientModifier

 sudo apt-get install redis

Sur Docker PHP : 

 RUN pecl install redis \
    && docker-php-ext-enable redis

CommandesModifier

Pour se loguer au serveur Redis : 

telnet nom_du_serveur 6379

Les commandes Redis les plus utiles[3] :

LectureModifier

  • MONITOR : suivre l'activité du serveur en temps réel.
  • KEYS * : liste des clés.
  • GET : affiche la valeur de la clé en paramètre (ou nil si elle n'existe pas).
  • MGET : affiche les valeurs des clés en paramètre.
  • QUIT : quitter.

ÉcritureModifier

  • SET : définit une valeur associée à la clé en paramètre[4].
  • EXPIRE : définit une durée avant expiration pour la clé en paramètre, en secondes.
  • SETEX : SET + EXPIRE[5].
  • DEL : supprimer par le nom complet de la clé.
  • FLUSHALL : vider toute la base de données.

Exemple de reset mémoire depuis le shell : 

echo "FLUSHALL" | nc -q 1 localhost 6379

redis-cliModifier

Pour afficher les clés de la base en shell : 

redis-cli KEYS '*'

Par défaut, redis-cli pointe sur 127.0.0.1. Pour regarder une autre machine : 

redis-cli -h redis.example.com KEYS '*'

Supprimer des clés par leurs noms[6] (exemple de celles qui ont le préfixe "users:") : 

redis-cli KEYS "users:*" | xargs redis-cli DEL

ou : 

redis-cli --scan --pattern users:* | xargs redis-cli DEL

Plusieurs basesModifier

Chaque instance de Redis peut accueillir jusqu'à 16 bases de données[7].

Elles sont accessibles par un suffixe dans leur DSN. Par défaut, redis://localhost:6379 pointe sur la base zéro : redis://localhost/0:6379.


Utilisation en PHPModifier

$redis = new \Redis();
$redis->connect('localhost', 6379);
$redis->set('nom du test', 'valeur du test');
echo $redis->get('nom du test');

predisModifier

Cette bibliothèque permet d'utiliser Redis en clustering, avec des masters et slaves[8].

Dans SymfonyModifier

Dans le framework PHP Symfony.

SessionModifier

SncRedisBundleModifier

Avant Symfony 4.1, il fallait passer par un bundle tel que SncRedisBundle[9]. 

composer require snc/redis-bundle predis/predis

Pour que les sessions soient stockées dans Redis au lieu de var/cache/, remplacer dans framework.yaml, session.handler_id: null par snc_redis.session.handler. Cela permet par exemple de les partager entre plusieurs conteneurs.

RedisSessionHandlerModifier

Depuis Symfony 4.1, le composant HttpFoundation contient une classe RedisSessionHandler[10].

Installation dans services.yaml : 

    redis:
        class: Redis
        calls:
            - connect:
                - '%env(REDIS_HOST)%'
                - '%env(int:REDIS_PORT)%'

    Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
        arguments:
            - '@redis'

Puis dans config/packages/framework.yaml[11] : 

framework:
    session:
        handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler

Ensuite le service session utilisera automatiquement Redis.

DoctrineModifier

Pour mettre le cache Doctrine de requête et de résultat dans Redis, on peut utiliser SncRedisBundle[12][13].

Pour vider les caches : 

bin/console cache:pool:clear doctrine.query_cache_pool doctrine.result_cache_pool doctrine.system_cache_pool

Cache chainéModifier

L'inconvénient de Redis ainsi configuré est que s'il tombe en panne, les applications qui l'utilisent crashent aussi (erreur de connexion à Redis dès l'instanciation des services).

Pour se prémunir de cela, il est recommandé d'inclure Redis dans un cache chainé, qui permet de basculer automatiquement sur des caches de secours sans bloquer l'application. Exemple[14] : 

# cache.yaml
framework:
    cache:
        prefix_seed: my_app_
        app: cache.chain
        pools:
            cache.chain:
                adapter: cache.adapter.psr6
                provider: chain_adapter_provider

            cache.redis:
                adapter: cache.adapter.redis
            cache.apcu:
                adapter: cache.adapter.apcu
            cache.filesystem:
                adapter: cache.adapter.filesystem

# services.yaml
services:
    chain_adapter_provider:
        class: Symfony\Component\Cache\Adapter\ChainAdapter
        arguments:
            - ['@cache.redis', '@cache.apcu', '@cache.filesystem']
            - '%env(int:CACHE_DEFAULT_LIFETIME)%'

RéférencesModifier

  1. ↑ https://aws.amazon.com/fr/elasticache/redis-vs-memcached/
  2. ↑ https://www.disko.fr/reflexions/technique/redis-vs-memcached/
  3. ↑ https://redis.io/commands
  4. ↑ https://redis.io/commands/set/
  5. ↑ https://redis.io/commands/setex/
  6. ↑ https://rdbtools.com/blog/redis-delete-keys-matching-pattern-using-scan/
  7. ↑ https://www.mikeperham.com/2015/09/24/storing-data-with-redis/
  8. ↑ https://github.com/predis/predis
  9. ↑ https://github.com/snc/SncRedisBundle/blob/master/Resources/doc/index.md
  10. ↑ https://github.com/symfony/symfony/blob/4.1/src/Symfony/Component/HttpFoundation/Session/Storage/Handler/RedisSessionHandler.php
  11. ↑ https://symfony.com/doc/current/session/database.html
  12. ↑ https://kunicmarko20.github.io/2017/07/20/Doctrine-Second-Level-Cache-with-Translations-and-Redis.html
  13. ↑ https://github.com/snc/SncRedisBundle/issues/554
  14. ↑ https://symfony.com/doc/current/components/cache/adapters/chain_adapter.html
Récupérée de « https://fr.wikibooks.org/w/index.php?title=Programmation_PHP/Redis&oldid=667640 »