Función PHP Memcached add()

La función Memcached::add() es una función incorporada de la clase memcached en PHP que se usa para establecer/agregar un valor dado bajo un valor dado con un tiempo de caducidad (TTL) en el servidor Memcache. Esta función es similar a la función Memcached::set(), pero la operación falla si la clave ya existe en el servidor.

Sintaxis:

public Memcached::add( $key,  $value,  $expiration = ?): bool

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

• clave: La clave bajo la cual almacenar el valor.
• valor: El valor a almacenar.
• caducidad: el tiempo de caducidad, por defecto es 0. Consulte Plazos de caducidad para obtener más información.

Valores devueltos: esta función devuelve verdadero en caso de que el par clave-valor se almacene correctamente y falso en caso de falla. La función Memcached::getResultCode() devolverá Memcached::RES_NOTSTORED si la clave ya existe.

Los siguientes ejemplos ilustran la función Memcached::add() 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";
}
  
// Set key & value with TTL
$key = "GEEKSFORGEEKS";
$value = "computer science portal";
$ttl = 3600;
  
if ($memcacheD->add($key, $value, $ttl)) 
      echo "** added key-value (" . $key . ":" 
      . $value . ")to cache successfully!! **\n";
else 
      echo "** error while adding value to cache!! **\n";
  
// Get value of key
echo "****   FETCHED VALUE   FOR KEY :"
      . $key . " ****\n";
  
$valD = $memcacheD->get($key);
var_dump($valD);
  
?>

Producción:

** servidor agregado **
** clave-valor agregado (GEEKSFORGEEKS: portal de informática) para almacenar en caché con éxito. **
**** VALOR OBTENIDO PARA LA CLAVE: GEEKSFORGEEKS ****
string (23) «portal de informática»

Ejemplo 2 (par de claves ya existente):

<?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";
}
  
// Set key & value with TTL
$key = "GEEKSFORGEEKS";
$value = "computer science portal";
$ttl = 3600;
  
if ($memcacheD->add($key, $value, $ttl))
      echo "** added key-value (" . $key . ":"
      . $value . ")to cache successfully!! **\n";
else 
      echo "** error while adding value to cache!! **\n";
  
// Get value of key
echo "****   FETCHED VALUE   FOR KEY :" 
      . $key . " ****\n";
  
$valD = $memcacheD->get($key);
var_dump($valD);
  
?>

Producción:

** servidor agregado **
** error al agregar valor a la memoria caché!! :: MSG:: NO ALMACENADO **
**** VALOR BUSCADO PARA LA CLAVE :geeksforgeeks ****
string(23) “portal de informática”

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