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