Il utilise l'API memcache de PHP (à ne pas confondre avec l'autre API: memcached). Il supporte uniquement la version 3.0.1 de memcache ou inférieur.

Dans le profil, vous devez indiquer un host et un port, ou plusieurs host/port. Voici un exemple avec un simple serveur:

[jkvdb:mymemcacheserver]
driver=memcache
host=localhost

Ou avec plusieurs serveurs:

[jkvdb:mymemcacheserver]
driver=memcache

host=memcache_server1:11211;memcache_server2:11212

; ou:
host[]=memcache_server1:11211
host[]=memcache_server2:11212

Vous pouvez aussi définir le paramètre compress=1, pour que les valeurs soient compressées lors du stockage.

Ce driver supporte l'interface jIKVttl.

Ce driver permet d'accéder à une base de données Redis.

Deux plugins sont disponibles :

• "redis_ext", fourni avec Jelix, se base sur l'API de l'extension PHP redis (plugin introduit dans Jelix 1.6.14)
• "redis_php", disponible séparément via le paquet Composer "jelix/php-redis-plugin", utilise une classe pure PHP (PhpRedis) pour communiquer avec la base Redis. (ce plugin était nommé "redis" avant Jelix 1.6.14)

Paramètres possibles :

Pour les configurer, il suffit d'indiquer un host et un paramètre port. Exemple :

[jkvdb:myredis]
driver=redis_ext
host = localhost
port = 6379

Ce driver supporte l'interface jIKVttl.

Depuis Jelix 1.6.8, il prend également en charge les paramètres suivants :

• db : le numéro de base de donnée redis (0 par défaut)
• key_prefix : un prefix qui sera ajouté sur chaque clé indiquée
• key_prefix_flush_method : méthode de suppression des clés quand on indique un prefixe.

Si vous indiquez un préfixe pour les clés, alors toutes les clés que vous indiquez seront préfixées par le préfixe en question dans la base Redis.

De même, le vidage du cache ne concernera que les clés commençant par ce préfixe. Cependant, à cause de l'implementation d'une telle fonction dans Redis, cela peut être très gourmand en temps, et rendre votre application trop lente.

Diverses méthodes sont implémentées dans le plugin pour supprimer les clés, et sont indiquées dans le paramètre key_prefix_flush_method :

• direct : les clés sont supprimées directement. Comportement par défaut. Mais à n'utiliser que si vous savez que votre base Redis ne contient pas beaucoup de clés.
• jkvdbredisworker : la suppression des clés sera faite de manière asynchrone par un worker ou un cron.
• event : si les deux autres méthodes ne vous conviennent pas, il est alors de votre responsabilité d'implémenter le processus (asynchrone de préférence !) qui vous convient. Un évènement jKvDbRedisFlushKeyPrefix est émis par le plugin, avec le nom du profile et le prefixe des clés à supprimer. à vous d'implémenter un listener sur cet évènement qui appellera votre processus de suppression.

Fonctionnement de la suppression asynchrone des clés à prefixes :

Le plugin stocke les prefixes des clés à supprimer dans une liste qui a pour clé jkvdbredisdelkeys dans Redis. Un worker ou un cron doit alors dépiler régulièrement cette liste de préfix et supprimer les clés correspondantes.

Vous avez un exemple de worker dans lib/jelix/core-modules/jelix/Command/RedisKvdbDeletionWorker.php. Vous pouvez le lancer au moyen de systemd/sysinit/supervisord par exemple. La commande sera alors php monappli/console.php jkvdb:redis:delete <profile> où <profile> est le nom du profile jkvdb concerné. La commande scrute en permanence la liste jkvdbredisdelkeys dans Redis et efface les clés correspondantes aux prefixes de cette liste. Pour l'arrêter, un <CTRL+C> (sur linux) suffira si vous le lancez vous même en ligne de commande.

Il permet d'utiliser une table SQL pour stocker les clé-valeurs. Pour le configurer, vous devez indiquer:

• table : le nom de la table à utiliser.
• dbprofile : le nom du profil jDb à utiliser pour accéder à la base SQL.

La table doit contenir trois champs, avec des noms et des types de champs spécifiques. Voici un script SQL pour créer de telles tables:

CREATE TABLE mykvdbtable (
k_key VARCHAR( 50 ) NOT NULL ,
k_value longblob NOT NULL ,
k_expire DATETIME NOT NULL ,
PRIMARY KEY (k_key)
);

Vous pouvez avoir plusieurs tables, pour éviter d'avoir des conflits entre les modules qui utilisent jKVDb.

Ce driver supporte l'interface jIKVttl

Il charge les valeurs dans des fichiers. Chaque fichier contient une valeur. Configuration:

• storage_dir: le répertoire où les fichiers sont placés. Peut contenir des raccourcis comme "var:" ou "temp:", le répertoire par défaut est var/kvfiles/.
• file_locking: false pour désactiver le "lock" de fichiers. True par défaut.
• automatic_cleaning_factor: donne la fréquence avec laquelle il faut nettoyer les fichiers trop vieux. 0 signifie jamais, 1 signifie pour chaque accès, plus élevé signifie une fréquence moins élevée..
• directory_level: si vous savez que vous aurez des milliers de valeurs, vous pouvez augmenter le nombre de niveau de répertoires: 2 par defaut.
• directory_umask: le umask des répertoires créés. 0700 par défaut.
• file_umask: le umask des fichiers créés. 0600 par défaut.

Ce driver supporte l'interface jIKVttl.

C'est un driver similaire au driver "file", mais en moins sophistiqué. Pas de paramètres de configuration et les fichiers sont stockés dans temp/filekv/.

Vous ne devez l'utiliser que pour des valeurs temporaires.