mikl Sat Feb 3 10:26:06 2007 UTC
Modified files: /phpdoc/en/reference/memcache/functions memcache-addserver.xml Log: Better info on the lazy connect bahaviour of addServer() http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/memcache/functions/memcache-addserver.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/memcache/functions/memcache-addserver.xml diff -u phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.7 phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.8 --- phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.7 Sat Jan 13 20:13:58 2007 +++ phpdoc/en/reference/memcache/functions/memcache-addserver.xml Sat Feb 3 10:26:05 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.Memcache-addServer"> <refnamediv> <refname>Memcache::addServer</refname> @@ -22,15 +22,20 @@ <para> <function>Memcache::addServer</function> adds a server to the connection - pool. The actual connection is established on first use. - The connection, which was opened using - <function>Memcache::addServer</function> will be automatically closed at the - end of script execution. Also you can close it with - <function>Memcache::close</function>. + pool. The connection, which was opened using <function>Memcache::addServer</function> + will be automatically closed at the end of script execution, you can also close it + manually with <function>Memcache::close</function>. You can also use the <function>memcache_add_server</function> function. </para> <para> + When using this method (as opposed to <function>Memcache::connect()</function> and + <function>Memcache::pconnect()</function>) 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. + </para> + + <para> 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