Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 05cd670d8a02b2b4a0ffb1756f2e8308 > files > 7830

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Memcache::addServer</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Memcache Functions"
HREF="ref.memcache.html"><LINK
REL="PREVIOUS"
TITLE="Memcache::add"
HREF="function.memcache-add.html"><LINK
REL="NEXT"
TITLE="Memcache::close"
HREF="function.memcache-close.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.memcache-add.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.memcache-close.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.Memcache-addServer"
></A
>Memcache::addServer</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN117877"
></A
><P
>    (no version information, might be only in CVS)</P
>Memcache::addServer&nbsp;--&nbsp;Add a memcached server to connection pool</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN117880"
></A
><H2
>说明</H2
>bool <B
CLASS="methodname"
>Memcache::addServer</B
> ( string host [, int port [, bool persistent [, int weight [, int timeout [, int retry_interval [, bool status [, callback failure_callback]]]]]]] )<BR
></BR
><P
>&#13;   <B
CLASS="function"
>Memcache::addServer()</B
> adds a server to the connection 
   pool. The connection, which was opened using <B
CLASS="function"
>Memcache::addServer()</B
> 
   will be automatically closed at the end of script execution, you can also close it 
   manually with <B
CLASS="function"
>Memcache::close()</B
>. 
   You can also use the <B
CLASS="function"
>memcache_add_server()</B
> function.
  </P
><P
>&#13;   When using this method (as opposed to <B
CLASS="function"
>Memcache::connect()()</B
> and 
   <B
CLASS="function"
>Memcache::pconnect()()</B
>) the network connection is not established 
   until actually needed. Thus there is no overhead in adding a large number of servers 
   to the pool, even though they might not all be used.
  </P
><P
>&#13;   Failover may occur at any stage in any of the methods, as long as other 
   servers are available the request the user won't notice. Any kind of 
   socket or Memcached server level errors (except out-of-memory) may trigger 
   the failover. Normal client errors such as adding an existing key will not 
   trigger a failover.
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
    This function has been added to Memcache version 2.0.0.
   </P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN117920"
></A
><H2
>参数</H2
><P
>&#13;   <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>host</CODE
></DT
><DD
><P
>&#13;       Point to the host where memcached is listening for connections.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>port</CODE
></DT
><DD
><P
>&#13;       Point to the port where memcached is listening for connections.
       This parameter is optional and its default value is 11211.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>persistent</CODE
></DT
><DD
><P
>&#13;       Controls the use of a persistent connection. Default to <TT
CLASS="constant"
><B
>TRUE</B
></TT
>.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>weight</CODE
></DT
><DD
><P
>&#13;       Number of buckets to create for this server which in turn control its
       probability of it being selected. The probability is relative to the
       total weight of all servers.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>timeout</CODE
></DT
><DD
><P
>&#13;       Value in seconds which will be used for connecting to the daemon. Think
       twice before changing the default value of 1 second - you can lose all
       the advantages of caching if your connection is too slow.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>retry_interval</CODE
></DT
><DD
><P
>&#13;       Controls how often a failed server will be retried, the default value
       is 15 seconds. Setting this parameter to -1 disables automatic retry. 
       Neither this nor the <CODE
CLASS="parameter"
>persistent</CODE
> parameter has any 
       effect when the extension is loaded dynamically via <A
HREF="function.dl.html"
><B
CLASS="function"
>dl()</B
></A
>.
      </P
><P
>&#13;       Each failed connection struct has its own timeout and before it has expired 
       the struct will be skipped when selecting backends to serve a request. Once 
       expired the connection will be successfully reconnected or marked as failed 
       for another <CODE
CLASS="parameter"
>retry_interval</CODE
> seconds. The typical 
       effect is that each web server child will retry the connection about every
       <CODE
CLASS="parameter"
>retry_interval</CODE
> seconds when serving a page.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>status</CODE
></DT
><DD
><P
>&#13;       Controls if the server should be flagged as online. Setting this parameter
       to <TT
CLASS="constant"
><B
>FALSE</B
></TT
> and <CODE
CLASS="parameter"
>retry_interval</CODE
> to -1 allows a failed 
       server to be kept in the pool so as not to affect the key distribution 
       algoritm. Requests for this server will then failover or fail immediatly 
       depending on the <CODE
CLASS="parameter"
>memcache.allow_failover</CODE
> setting.
       Default to <TT
CLASS="constant"
><B
>TRUE</B
></TT
>, meaning the server should be considered online.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>failure_callback</CODE
></DT
><DD
><P
>&#13;       Allows the user to specify a callback function to run upon encountering an 
       error. The callback is run before failover is attemped. The function takes 
       two parameters, the hostname and port of the failed server.
      </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN117974"
></A
><H2
>返回值</H2
><P
>&#13;   如果成功则返回 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>，失败则返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN117979"
></A
><H2
>范例</H2
><P
>&#13;   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN117982"
></A
><P
><B
>例 1. <B
CLASS="function"
>Memcache::addServer()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /><br /></font><font color="#FF8000">/* OO API */<br /><br /></font><font color="#0000BB">$memcache </font><font color="#007700">= new </font><font color="#0000BB">Memcache</font><font color="#007700">;<br /></font><font color="#0000BB">$memcache</font><font color="#007700">-&gt;</font><font color="#0000BB">addServer</font><font color="#007700">(</font><font color="#DD0000">'memcache_host'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /></font><font color="#0000BB">$memcache</font><font color="#007700">-&gt;</font><font color="#0000BB">addServer</font><font color="#007700">(</font><font color="#DD0000">'memcache_host2'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* procedural API */<br /><br /></font><font color="#0000BB">$memcache_obj </font><font color="#007700">= </font><font color="#0000BB">memcache_connect</font><font color="#007700">(</font><font color="#DD0000">'memcache_host'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /></font><font color="#0000BB">memcache_add_server</font><font color="#007700">(</font><font color="#0000BB">$memcache_obj</font><font color="#007700">, </font><font color="#DD0000">'memcache_host2'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN117986"
></A
><H2
>参见</H2
><P
>&#13;   <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><B
CLASS="function"
>Memcache::connect()</B
></TD
></TR
><TR
><TD
><B
CLASS="function"
>Memcache::pconnect()</B
></TD
></TR
><TR
><TD
><B
CLASS="function"
>Memcache::close()</B
></TD
></TR
><TR
><TD
><B
CLASS="function"
>Memcache::setServerParams()</B
></TD
></TR
><TR
><TD
><B
CLASS="function"
>Memcache::getServerStatus()</B
></TD
></TR
></TBODY
></TABLE
><P
></P
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.memcache-add.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.memcache-close.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Memcache::add</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.memcache.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Memcache::close</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional