Differences

This shows you the differences between two versions of the page.

--- v5:userguide:memcached [2017/04/18 10:32] – [Using Debug Mode] fix formatting (use code block) dregad
+++ v5:userguide:memcached [2025/06/01 13:21] (current) – Remove square brackets in tags dregad
@@ Line 1: / Line 1: @@
 ====== Memcached Setup ======
+===== Description =====
+This section describes connecting to an already configured Memcache server. Information about installation and configuration of Memcached servers can be found [[https://memcached.org/|here]].
+===== The Memcache Library =====
+There are 2 distinct PEAR modules for connecting to a [[wp>Memcached]] server: the [[https://pecl.php.net/package/memcache|Memcache]] library and the [[https://pecl.php.net/package/memcached|Memcached]] library.
 <WRAP tip>
-There are 2 PEAR modules for connecting to a [[wp>Memcached]] server: the [[https://pecl.php.net/package/memcache|Memcache]] library and the [[https://pecl.php.net/package/memcached|Memcached]] library.
   * Windows support is only available for the //Memcache// library.
   * //Memcache// should be used in PHP 5.x environments on UNIX platforms.
@@ Line 8: / Line 12: @@
   * If both libraries are available, //Memcache// will be used.
 </WRAP>
+===== Why can't I use the memcached library under Windows? =====
-===== Description =====
+The memcached library is much more heavily featured, more modern and better maintained. The problem with it is not a problem with ADOdb, nor a problem with PHP. The PHP module is dependent on the 3rd party library **libmemcache**, which has no Windows support. Any Windows DLLs you might find floating around the web will __always__ be built on the memcache library.
-This section describes connecting to an already configured Memcache server. Information about installation and configuration of Memcached servers can be found [[https://memcached.org/|here]].
-===== The Memcache Library =====
@@ Line 36: / Line 38: @@
 /*
  * Use 'true' to store the item compressed (uses zlib)
- * Note; Compression is only supported using the memcache library. This
- *       parameter will be ignored when using the memcached library
  */
 $db->memCacheCompress = false;
@@ Line 53: / Line 53: @@
 </code>
+===== Adding Weighted Server Groups =====
+From ADOdb version 5.22, the **memcached** library supports the use of **//Weighted server groups//**, in which a specific server can be forced to return a result a specific percentage of the time.
+If the feature is used, the total weighting of the server group must equal 100%.  To achieve this, the configuration of the servers must be defined in a different way to the default. Each host is defined as an array:
+<code php>
+array(
+ 'host'=> The host name,
+ 'port'=> The port, defaults to 11211,
+ 'weight'=> A percentage, up to 100,
+);
+</code>
+The host arrays are then combined together. In this example 86.91 serves 70% of requests and 86.92 serves 30%
+<code php>
+$hosts = array(
+    array('host'=>'192.168.86.91','port'=>'11211','weight'=>70),
+    array('host'=>'192.168.86.92','port'=>'11211','weight'=>30),
+    );
+$db = NewADOConnection($driver='mysqli');
+/*
+ * Enable memcache
+ */
+$db->memCache = true;
+/*
+ * Add the weighted servers in $memCacheHosts. All other parameters are ignored.
+ */
+$db->memCacheHost = $hosts
+</code>
+===== Adding options to the memcached server =====
+From ADOdb version 5.22, [[https://www.php.net/manual/en/memcached.setoption.php|server options]] can be set on the **Memcached** connection by use of the **memCacheOptions** array
+<code php>
+$hosts = array(
+    array('host'=>'192.168.86.91','port'=>'11211','weight'=>70)
+    array('host'=>'192.168.86.92','port'=>'11211','weight'=>30)
+    );
+$db = NewADOConnection($driver='mysqli');
+/*
+ * Enable memcache
+ */
+$db->memCache = true;
+/*
+ * Add the weighted servers in $memCacheHosts
+ */
+$db->memCacheHost = $hosts;
+/*
+* Set some options
+*/
+$db->memCacheOptions = array(Memcached::OPT_HASH=>Memcached::HASH_MURMUR);
+</code>
 ===== Using Debug Mode  =====
@@ Line 81: / Line 145: @@
-{{tag>[memcached cache]}}
+{{tag>memcached cache}}