Document the multi-host DSN for Memcache caches

javiereguiluz · javiereguiluz · commit 1ae951bbf9e5 · 2019-01-22T08:57:04.000+01:00
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
@@ -64,6 +64,16 @@ helper method allows creating and configuring a `Memcached`_ class instance usin
         // etc...
     ]);
 
+    // a single DSN can define multiple servers using the following syntax:
+    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    $client = MemcachedAdapter::createConnection(
+        'memcached:?host[localhost]&host[localhost:12345]&host[/some/memcached.sock:]=3'
+    );
+
+.. versionadded:: 4.2
+
+    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
+
 The `Data Source Name (DSN)`_ for this adapter must use the following format:
 
 .. code-block:: text
