函式名:Memcache::addServer()
適用版本:PHP 4 >= 4.3.0, PHP 5, PHP 7
用法:Memcache::addServer ( string $host [, int $port = 11211 [, bool $persistent = TRUE [, int $weight = 0 [, int $timeout = 0 [, int $retry_interval = 0 [, bool $status = TRUE [, callable $failure_callback = NULL [, int $timeoutms = NULL ]]]]]]]] ) : bool
說明:Memcache::addServer() 函式用於向已經例項化的 Memcache 物件新增一個或多個 Memcached 伺服器。
引數:
- host:伺服器的主機名或 IP 地址。
- port:可選引數,伺服器的埠號,預設為11211。
- persistent:可選引數,是否使用持久連線,預設為TRUE。
- weight:可選引數,伺服器的權重,預設為0。
- timeout:可選引數,連線伺服器的超時時間,預設為0(無限制)。
- retry_interval:可選引數,伺服器連線失敗時的重試間隔時間,預設為0(不重試)。
- status:可選引數,伺服器的初始狀態,預設為TRUE(可用)。
- failure_callback:可選引數,連線失敗時呼叫的回撥函式。
- timeoutms:可選引數,連線伺服器的超時時間(以毫秒為單位)。
返回值:如果成功新增伺服器,則返回 TRUE,否則返回 FALSE。
示例:
$memcache = new Memcache;
$memcache->addServer('127.0.0.1', 11211);
$memcache->addServer('192.168.0.1', 11211, false, 1, 3, 2, true, 'failure_callback', 1000);
在上面的示例中,我們首先建立了一個 Memcache 物件,然後使用 addServer() 函式將兩個 Memcached 伺服器新增到該物件中。第一個伺服器的主機名為 '127.0.0.1',埠號為 11211,預設使用持久連線。第二個伺服器的主機名為 '192.168.0.1',埠號為 11211,不使用持久連線,權重為 1,連線超時時間為 3 秒,連線失敗時每隔 2 秒重試一次,初始狀態為可用,連線超時時間為 1000 毫秒。