Memcache::setServerParams
(No version information available, might be only in CVS)
Memcache::setServerParams — Modifit les paramètres et les statuts du serveur pendant l'exécution
Description
Memcache::setServerParams() modifit 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
-
Pointe à l'hôte où memcache écoute pour des connexions.
- port
-
Pointe au port où memcache écoute pour des connexions. Ce paramètre est optionnel et sa valeur par défaut est 11211.
- timeout
-
Valeur en seconde qui sera utilisée pour se connecter au daemon. 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 un serveur qui échoue sera retenté, 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 flaggué comme étant en ligne. Si ce paramètre vaut FALSE et le paramètre retry_interval -1, cela permet de conserver un serveur qui a échoué dans la liste et n'affectera pas l'algorythme de distribution des clés. Les demandes pour ce serveur échoueront immédiatement suivant la configuration du paramètre memcache.allow_failover . Par défaut, ce paramètre vaut TRUE, signifiant que le serveur doit être considéré comme étant en ligne.
- failure_callback
-
Permet à l'utilisateur de spécifier une fonction de callback permettant de contourner une erreur. Le callback est exécuté 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, FALSE en cas d'échec.
Exemples
Example#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()
- Memcache::getServerStatus()