Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKey — Substitua o item em uma key existente em um servidor específico

Descrição

public Memcached::replaceByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): bool

Memcached::replaceByKey() é funcionalmente equivalente a Memcached::replace(), exceto que a forma livre server_key pode ser usada para mapear a key para um servidor específico. Isso é útil se você precisar manter várias keys relacionadas em um determinado servidor.

Parâmetros

server_key

A chave que identifica o servidor no qual armazenar o valor ou de onde recuperá-lo. Em vez de fazer o hash na chave real do item, o hash é feito na chave do servidor ao decidir com qual servidor memcached se comunicar. Isso permite que itens relacionados sejam agrupados em um único servidor para eficiência com múltiplas operações.

key

A chave sob a qual armazenar o valor.

value

O valor a ser armazenado.

expiration

O tempo de expiração padrão é 0. Consulte Tempos de Expiração para mais informações.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha. O Memcached::getResultCode() retornará Memcached::RES_NOTSTORED se a key não existir.

Veja Também