Memcached::addServer

(PECL memcached >= 0.1.0)

Memcached::addServerAñade un servidor al grupo

Descripción

public Memcached::addServer(string $host, int $port, int $weight = 0): bool

Memcached::addServer() añade el servidor indicado al grupo de servidores. No se establece ninguna conexión en ese momento, pero si se utiliza la clave de distribución por hash consistente (a través de Memcached::DISTRIBUTION_CONSISTENT o Memcached::OPT_LIBKETAMA_COMPATIBLE), ciertas estructuras internas van a ser actualizadas. Por lo tanto, si es necesario añadir varios servidores, se recomienda utilizar Memcached::addServers() para que la actualización ocurra una sola vez.

El mismo servidor puede aparecer varias veces en el grupo, ya que no se realiza ninguna búsqueda de duplicados. Esto no es recomendado: en su lugar, utilice el argumento weight para aumentar el peso de un servidor en la selección.

Parámetros

host

El nombre de host del servidor memcache. Si el nombre de host no es válido, las operaciones sobre los datos van a definir el código de resultado Memcached::RES_HOST_LOOKUP_FAILURE. Desde la versión 2.0.0b1, este argumento también puede especificar la ruta hacia un socket Unix, por ejemplo; /ruta/hacia/memcached.sock para utilizar el socket de dominio Unix, y en este caso, el argumento port también debe ser definido a 0.

port

El puerto en el que memcache funciona. Generalmente, es 11211. Desde la versión 2.0.0b1, defina este argumento a 0 cuando se utilicen sockets de dominio Unix.

weight

El peso del servidor relativamente al peso total de todos los servidores. Esto controla la probabilidad de que un servidor sea seleccionado durante las operaciones. Esta opción solo se utiliza con la distribución consistente, y generalmente, esto corresponde al total de memoria disponible en este servidor.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con Memcached::addServer()

<?php
$m
= new Memcached();

/* Añade dos servidores, y el segundo es dos veces
más solicitado que el primero */
$m->addServer('mem1.domain.com', 11211, 33);
$m->addServer('mem2.domain.com', 11211, 67);
?>

Ver también