array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'memcached.addserver.php', 1 => 'Memcached::addServer', 2 => 'Adiciona um servidor ao pool de servidores', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.addbykey.php', 1 => 'Memcached::addByKey', ), 'next' => array ( 0 => 'memcached.addservers.php', 1 => 'Memcached::addServers', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/memcached/memcached/addserver.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 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.

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

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);
?>

Veja Também