Función PHP Memcached addServer()

La función Memcached::add() es una función incorporada de la clase memcached en PHP que se usa para agregar un servidor al grupo de servidores. Agrega el servidor especificado al grupo de servidores. No se establece ninguna conexión con el servidor en este momento, pero si está utilizando la opción de distribución de claves consistente (a través de Memcached::DISTRIBUTION_CONSISTENT o Memcached::OPT_LIBKETAMA_COMPATIBLE), algunas de las estructuras de datos internas deberán actualizarse. Por lo tanto, si necesita agregar varios servidores, es mejor usar Memcached::addServers() ya que la actualización solo ocurre una vez.

El mismo servidor puede aparecer varias veces en el grupo de servidores porque no se realizan comprobaciones de duplicación. Esto no es aconsejable; en su lugar, utilice la opción de ponderación para aumentar la ponderación de la selección de este servidor.

Sintaxis:

public Memcached::addServer( $host, $puerto, $peso = 0): bool

Parámetros: Esta función acepta tres parámetros que son:

• host: el nombre de host del servidor Memcache.
• puerto: el puerto en el que se ejecuta Memcache. Por lo general, esto es 11211.
• peso: el peso del servidor en relación con el peso total de todos los servidores del grupo. Se utiliza para el equilibrio de carga.

Valores devueltos: Devuelve verdadero en caso de éxito o falso en caso de error.

El siguiente programa ilustra la función Memcached::addServer() en PHP:

Ejemplo 1:

<?php
  
echo "<pre>";
  
// Server & port details
$server = '127.0.0.1';
$port = 11211;
  
// Initiate a new object of memcache
$memcacheD = new Memcached();
  
// Add server
if ($memcacheD->addServer($server, $port)) {
    echo "**  server added ** \n";
}
else {
    echo "** issue while creating a server **\n";
}
  
// Get server detail
echo "Server Details :: \n";
var_dump($memcacheD->getServerList());
  
?>

Producción:

** servidor agregado **
Detalles del servidor::array(1) {
[0]=>array(3) {
[“host”]=>string(9) “127.0.0.1”
[“port”]=>int( 11211)
[“tipo”]=>string(3) “TCP”
}
}

Ejemplo 2 (error al crear el servidor: puerto ya utilizado):

<?php
echo "<pre>";
  
// Server & port details
$server = '127.0.0.1';
$port = "8000";
  
// Initiate a new object of memcache
$memcacheD = new Memcached();
  
// Add server
if ($memcacheD->addServer($server, $port)) {
    echo "**  server added ** \n";
}
else {
    echo "** issue while creating a server **\n";
}
  
// Get server detail
echo "Server Details :: \n"; 
var_dump($memcacheD->getServerList());
  
?>

Producción:

** servidor agregado **
*** problema al crear un servidor **
Detalles del servidor ::

Referencia: https://www.php.net/manual/en/memcached.addserver.php