(PECL memcached >= 0.1.0)
Memcached::addServer — Añade un servidor a la provisión de servidores
$host
, int $port
[, int $weight = 0
] )
Memcached::addServer() añade el servidor especificado a la
provisión de servidores. En esta operación no se establece una conexión al servidor, aunque
si se emplea la opción de distribución de claves (a través de
Memcached::DISTRIBUTION_CONSISTENT o
Memcached::OPT_LIBKETAMA_COMPATIBLE), algunas de las
estructuras de datos internas deberán ser actualizadas. Así, si fuera necesario añadir
varios servidores, es mejor utilizar
Memcached::addServers(), ya que la actualización se realiza
una única vez.
El mismo servidor podría aparecer varias veces en la provisión de servidores, debido a que no
se realiza ninguna comprobación de duplicados. Esta característica 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 relacinadas con datos establecerán el
código de resultado Memcached::RES_HOST_LOOKUP_FAILURE. A
partir de la versión 2.0.0b1, este parámetro puede también especificar la ruta de un
socket de unix, p.ej., /ruta/a/memcached.sock,
para emplear socket de dominio de UNIX; en este caso también se debe establecer
port a 0.
portEl puerto en que memcache está funcionado. Normalmente es 11211. A partir de la versión 2.0.0b1, se debe establecer este parámetro a 0 al utilizar socket de dominio UNIX.
weightEl peso (importancia) del servidor relativo al peso total de todos los servidores en la provisió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.dominio.com', 11211, 33);
$m->addServer('mem2.dominio.com', 11211, 67);
?>