Edit Report a Bug

    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_CONSISTENT 或 Memcached::OPT_LIBKETAMA_COMPATIBLE），则必须更新一些内部的数据结构。 因此，如果需要增加多台服务器，最好使用 Memcached::addServers() 以确保这种更新只发生一次。

    同一台服务器可以在服务器池中多次出现，因为没有做重复检测。但并不推荐这样做，对于期望提高某台服务器的权重，请使用 weight 参数。

    参数

    host

    memcached 服务端主机名。如果主机名无效，相关的数据操作的结果代码将被设置为 Memcached::RES_HOST_LOOKUP_FAILURE。从 2.0.0b1 版本开始，这个参数还可以指定 unix 套接字文件的路径。例如：/path/to/memcached.sock 使用 UNIX 域套接字，在这种情况下 port 也必须设置为 0。

    port

    运行 memcached 的端口号，通常是 11211。从版本 2.0.0b1 开始，在使用 UNIX 域套接字时将此参数设置为 0。

    weight

    此服务器相对于服务器池中所有服务器的权重。此参数用来控制服务器在操作时被选中的概率。这个仅用于一致性分布选项，并且这个值通常是由服务端分配的内存来设置的。

    返回值

    成功时返回 true， 或者在失败时返回 false。

    示例

    示例 #1 Memcached::addServer() 示例

    <?php
    $m     = new Memcached();

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

    参见

    add a note add a note

    User Contributed Notes 3 notes

    up
    10
    Dave
    12 years ago
    As of version 2.0.0b1 you can use Unix socket.

    <?php
    $m     = new Memcached();
    $m->addServer('/path/to/socket',0);
    ?>

    Not to be confused with Memcache that use 'unix:///path/to/socket'
    up
    8
    mbarriolinares at gmail dot com
    12 years ago
    Important to not call ->addServers() every run -- only call it if no servers exist (check getServerList() ); otherwise, since addServers() does not check for dups, it will let you add the same server again and again and again, resultings in hundreds if not thousands of connections to the MC daemon. Specially when using FastCGI.

    Example:

    <?php
    class Cache {
            private     $id;
            private     $obj;

            function     __construct($id){
                        $this->id = $id;
                        $this->obj = new Memcached($id);
            }

            public function     connect($host , $port){
                        $servers = $this->obj->getServerList();
                    if(    is_array($servers)) {
                            foreach (    $servers as $server)
                                    if(    $server['host'] == $host and $server['port'] == $port)
                                            return     true;
                    }
                    return     $this->obj->addServer($host , $port);
            }

    }
    ?>
    up
    0
    Robbie De Lise
    13 years ago
    On my Debian Squeeze system I was getting WRITE FAILURE errors. After debugging and finally tcpdump it seems that the problem was me adding the server 'localhost', which resolved to '::1' (ipv6) while the default memcached server on debian only listens to '127.0.0.1' (ipv4). DNS automatically prefers ipv6 over ipv4.

    I added the server '127.0.0.1' instead and everything worked. You could also disable ipv6 or have memcached listen on ::1
    add a note add a note
    To Top