array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'memcached.setbykey.php', 1 => 'Memcached::setByKey', 2 => 'Armazena um item em um servidor específico', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.set.php', 1 => 'Memcached::set', ), 'next' => array ( 0 => 'memcached.setencodingkey.php', 1 => 'Memcached::setEncodingKey', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/memcached/memcached/setbykey.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — Armazena um item em um servidor específico

Descrição

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

Memcached::setByKey() é funcionalmente equivalente a Memcached::set(), 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 chaves 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. Use Memcached::getResultCode() se necessário.

Exemplos

Exemplo #1 Exemplo de Memcached::setByKey()

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

/* manter blocos de IP em um determinado servidor */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>

Veja Também