Memcached::addServer

(PECL memcached >= 0.1.0)

Memcached::addServer — Adiciona um servidor ao pool de servidores

Descrição

public Memcached::addServer(string $host, int $port, int $weight = 0): bool

Memcached::addServer() adiciona o servidor especificado ao pool de servidores. Nenhuma conexão é estabelecida com o servidor neste momento, mas se você estiver usando a opção de distribuição de key consistente (via Memcached::DISTRIBUTION_CONSISTENT ou Memcached::OPT_LIBKETAMA_COMPATIBLE), algumas das estruturas de dados internas terão que ser atualizadas. Portanto, se você precisar adicionar vários servidores, é melhor usar o Memcached::addServers(), pois a atualização ocorrerá apenas uma vez.

O mesmo servidor pode aparecer várias vezes no pool de servidores porque nenhuma verificação de duplicação é feita. Isso não é aconselhável; em vez disso, use weight para aumentar o peso da seleção desse servidor.

Parâmetros

host

O nome do host do servidor memcache. Se o nome do host for inválido, as operações relacionadas a dados definirão o código de resultado Memcached::RES_HOST_LOOKUP_FAILURE. A partir da versão 2.0.0b1, este parâmetro também pode especificar o caminho de um arquivo de socket unix ex. /path/to/memcached.sock para usar sockets de domínio UNIX, neste caso, port também deve ser definida como 0.

port

A porta na qual o memcache está em execução. Geralmente, é 11211. A partir da versão 2.0.0b1, defina esse parâmetro como 0 ao usar sockets de domínio UNIX.

weight

O peso do servidor relativo ao peso total de todos os servidores no pool. Isso controla a probabilidade do servidor ser selecionado para operações. Isso é usado apenas com opção de distribuição consistente e geralmente corresponde à quantidade de memória disponível para memcache naquele servidor.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 Memcached::addServer() exemplo

<?php
$m = new Memcached();

/* Adiciona 2 servidores, para que o segundo
   tem duas vezes mais chances de ser selecionado. */
$m->addServer('mem1.domain.com', 11211, 33);
$m->addServer('mem2.domain.com', 11211, 67);
?>

Veja Também