(PECL memcached >= 0.1.0)
Memcached::addServer — Añade un servidor a la agrupación de servidores
$host
, int $port
[, int $weight = 0
] )
Memcached::addServer() añade el servidor especificado a la
agrupación de servidores. No se establece una conexión al servidor en esta operación, pero
si se emplea la opción de distribución claves (a través de
Memcached::DISTRIBUTION_CONSISTENT o
Memcached::OPT_LIBKETAMA_COMPATIBLE), algunas de las
estructuras de datos internas deberán ser actualizadas. Por lo tanto, si fuera necesario añadir
varios servidores, es mejor utilizar
Memcached::addServers(), ya que la actualización sucede
una única vez.
El mismo servidor podría aparecer varias veces en la agrupación de servidores, debido a que no
se realizón ninguna comprobación de duplicados. Esto no es aconsejable; emplee en su lugar la opción
weight para aumentar el peso de selección (importancia)
de dicho servidor.
host
El nombre de host del servidor de memcache. Si el nombre de host no es válido, las operaciones
con datos relacionados devolverán el código
Memcached::RES_HOST_LOOKUP_FAILURE como resultado.
portEl puerto en que memcache está funcionado. Normalmente es 11211.
weightEl peso (importancia) del servidor relativa al peso total de todos los servidores en la agrupación. Controla la probabilidad de que un servidor sea elegido para realizar operaciones. Solamente se utiliza para la opción de distribución consistente y normalmente corresponde a la cantidad de memoria disponible para memcache en dicho servidor.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Ejemplo #1 Ejemplo de Memcached::addServer()
<?php
$m = new Memcached();
/* Añadir 2 servidores, de forma que el segundo
tiene el doble de probabilidades de ser seleccionado. */
$m->addServer('mem1.domain.com', 11211, 33);
$m->addServer('mem2.domain.com', 11211, 67);
?>