Memcache::setServerParams
(PECL memcache >= 2.1.0)
Memcache::setServerParams — Modifit les paramètres et les statuts du serveur pendant l'exécution
Description
$host
[, int $port
= 11211
[, int $timeout
[, int $retry_interval
= false
[, bool $status
[, callable $failure_callback
]]]]] )Memcache::setServerParams() modifie les paramètres du serveur durant l'exécution. Vous pouvez également utiliser la fonction memcache_set_server_params().
Note:
Cette fonction a été ajoutée en Memcache version 2.1.0.
Liste de paramètres
-
host
-
Hôte où memcache écoute pour des connexions.
-
port
-
Port où memcache écoute pour des connexions.
-
timeout
-
Valeur en seconde qui sera utilisée pour se connecter au démon. Pensez-y deux fois avant de changer la valeur par défaut d'une seconde - vous pourriez perdre tous les avantages de l'utilisation de la cache si votre connexion est trop lente.
-
retry_interval
-
Contrôle combien de fois la connexion à un serveur qui échoue sera essayée : la valeur par défaut est de 15 secondes. Si ce paramètre vaut -1, aucune nouvelle tentative ne sera effectuée. Ni ce paramètre, ni le paramètre
persistent
n'ont d'effet lorsque cette extension est chargée dynamiquement via la fonction dl(). -
status
-
Contrôle si le serveur doit être indiqué comme étant en ligne. Quand ce paramètre vaut
FALSE
et le paramètreretry_interval
vaut -1, cela permet de conserver un serveur qui a échoué dans la liste et n'affectera pas l'algorithme de distribution des clés. Les demandes pour ce serveur échoueront immédiatement suivant la configuration du paramètrememcache.allow_failover
. Par défaut, ce paramètre vautTRUE
, signifiant que le serveur doit être considéré comme étant en ligne. -
failure_callback
-
Permet à l'utilisateur de spécifier une fonction de rappel permettant de contourner une erreur. Le fonction est exécutée avant d'atteindre la limite de tentative. La fonction prend deux paramètres ; le nom de l'hôte et le port du serveur qui a échoué.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Exemple avec Memcache::setServerParams()
<?php function _callback_memcache_failure($host, $port) { print "memcache '$host:$port' failed"; } /* API orientée objet */ $memcache = new Memcache; // Ajoute le serveur en mode hors ligne $memcache->addServer('memcache_host', 11211, false, 1, 1, -1, false); // Replace le serveur en ligne $memcache->setServerParams('memcache_host', 11211, 1, 15, true, '_callback_memcache_failure'); /* API procédurale */ $memcache_obj = memcache_connect('memcache_host', 11211); memcache_set_server_params($memcache_obj, 'memcache_host', 11211, 1, 15, true, '_callback_memcache_failure'); ?>
Voir aussi
- Memcache::addServer() - Ajoute un serveur memcache à la liste de connexion
- Memcache::getServerStatus() - Retourne le statut du serveur