Armazena um item em um servidor específico

# Memcached::setByKey

(PECL memcached >= 0.1.0)

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

### Descrição

public function 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

- Memcached::set() - Armazena um item

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open