(PECL memcached >= 0.1.0)
Memcached::addServer — Adiciona um servidor ao pool de servidores
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 chave 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.
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.
Exemplo #1 Exemplo de Memcached::addServer()
<?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);
?>