Memcached::addServer
(PECL memcached >= 0.1.0)
Memcached::addServer — Ajoute un serveur au pool
Description
$host
, int $port
[, int $weight
= 0
] )
Memcached::addServer() ajoute le serveur indiqué
au pool de serveurs. Aucune connexion n'est établie à ce moment-là, mais
si vous utilisez la clé de distribution par hashage cohérent (via
Memcached::DISTRIBUTION_CONSISTENT
ou
Memcached::OPT_LIBKETAMA_COMPATIBLE
), certaines structures
internes vont être mises à jour. Par conséquent, si vous devez ajouter plusieurs
serveurs, il est recommandé d'utiliser Memcached::addServers()
pour que la mise à jour n'arrive qu'une seule fois.
Le même serveur peut apparaître plusieurs fois dans le pool, car aucune
recherche de doublon n'est faite. Ce n'est pas recommandé : utilisez plutôt
le paramètre weight
pour augmenter le poids d'un serveur
dans la sélection.
Liste de paramètres
-
host
-
Le nom d'hôte du serveur. Si le nom d'hôte est invalide, les fonctions d'état d'opération vont retourner le code de résultat
Memcached::RES_HOST_LOOKUP_FAILURE
. -
port
-
Le port sur lequel memcache fonctionne. Généralement, c'est 11211.
-
weight
-
Le poids du serveur relativement au poids total de tous les serveurs. Cela contrôle la probabilité qu'un serveur soit sélectionné durant les opérations. Cette option n'est utilisée qu'avec la distribution cohérente, et généralement, cela correspond au total de mémoire disponible sur ce serveur.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Exemple avec Memcached::cas()
<?php $m = new Memcached(); /* Ajoute deux serveurs, et le second est deux fois plus sollicité que le premier */ $m->addServer('mem1.domain.com', 11211, 33); $m->addServer('mem2.domain.com', 11211, 67); ?>
Voir aussi
- Memcached::addServers() - Ajoute plusieurs serveurs au pool
- Memcached::resetServerList() - Supprime tous les serveurs depuis la liste des serveurs