(PECL memcached >= 0.1.0)
Memcached::addServer — サーバをサーバプールに追加する
Memcached::addServer() は、指定したサーバをサーバプールに追加します。 この時点では、サーバへの接続は確立されません。しかし、一貫性のあるキー分散オプションを (Memcached::DISTRIBUTION_CONSISTENT あるいは Memcached::OPT_LIBKETAMA_COMPATIBLE で) 指定した場合は、 内部データ構造のうちの一部が更新されます。 したがって、もし複数のサーバを追加したい場合は、 Memcached::addServers() を使用するほうがよいでしょう。 その場合、更新は一度しか発生しません。
同じサーバがサーバプール内で複数回あらわれることもあります。 重複チェックはしていないからです。これは望ましい状態ではありません。 その代わりに weight オプションを使用して、 このサーバを選択する重みを増やします。
memcache サーバのホスト名。ホスト名が無効な場合は、データ関連の操作の結果コードに Memcached::RES_HOST_LOOKUP_FAILURE が設定されます。
memcache が動作しているポート。通常、これは 11211 となります。
プール内の全サーバにおけるそのサーバの重み。 これで、何か操作をしたときにそのサーバが選択される確率を制御します。 これは、一貫性のある分散オプションを使っている場合にのみ使用でき、 通常はそのサーバ上で memcache が使用できるメモリの量に対応したものとなります。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例1 Memcached::addServer() の例
<?php
$m = new Memcached();
/* 2 つのサーバを追加し、2 番目のサーバが
最初のサーバの 2 倍の確率で選択されるようにします */
$m->addServer('mem1.domain.com', 11211, 33);
$m->addServer('mem2.domain.com', 11211, 67);
?>