Memcached::addServer

(PECL memcached >= 0.1.0)

Memcached::addServer向服務器池中增加一個服務器

說明

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

Memcached::addServer()增加指定服務器到服務器池中。此時不會建立與服務端的連接, 但是,如果你使用一致性key分布選項(Memcached::DISTRIBUTION_CONSISTENTMemcached::OPT_LIBKETAMA_COMPATIBLE),一些內部的數據結構將會被更新。 因此,如果你需要增加多臺服務器,更好的方式是使用Memcached::addServers() 以確保這種更新只發(fā)生一次。

同一臺服務器可以在服務器池中多次出現,因為這里沒有做重復檢測。但這是不推薦的做法,對于期望提高某臺服務器 權重的需求,請使用weight參數。

參數

host

memcached服務端主機名。如果主機名無效,相關的數據操作的返回代碼將被設置為Memcached::RES_HOST_LOOKUP_FAILURE

port

memcached服務端端口號,通常是11211

weight

此服務器相對于服務器池中所有服務器的權重。此參數用來控制服務器在操作時被選種的概率。這個僅用于一致性 分布選項,并且這個值通常是由服務端分配的內存來設置的。

返回值

成功時返回 true, 或者在失敗時返回 false。

范例

示例 #1 Memcached::addServer() example

<?php
$m 
= new Memcached();

/* Add 2 servers, so that the second one
   is twice as likely to be selected. */
$m->addServer('mem1.domain.com'1121133);
$m->addServer('mem2.domain.com'1121167);
?>

參見