Memcached::incrementByKey

(PECL memcached >= 2.0.0)

Memcached::incrementByKey — Incrementa un valor numérico de un elemento almacenado en un servidor específico

Descripción

public Memcached::incrementByKey(
    string $server_key,
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false

Memcached::incrementByKey() incrementa un valor numérico de un elemento especificando el incremento mediante el argumento offset. Si el valor del elemento no es numérico, se emitirá un error. Memcached::incrementByKey() establecerá el elemento al valor del argumento initial_value si la clave no existe.

Parámetros

server_key: La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.
key: La clave del elemento a incrementar.
offset: El incremento a utilizar sobre el valor del elemento.
initial_value: El valor a establecer si el elemento no existe.
expiry: El tiempo de expiración para la definición del elemento.

Valores devueltos

Devuelve el nuevo valor del elemento en caso de éxito o false si ocurre un error.

Ver también

Memcached::decrement() - Disminuye un valor numérico
Memcached::decrementByKey() - Disminuye un valor numérico de un elemento almacenado en un servidor específico
Memcached::increment() - Incrementa numéricamente un elemento