minor #10907 Document the multi-host DSN for Memcache caches (javiereguiluz)

javiereguiluz · javiereguiluz · commit 8cecddd0f9bc · 2019-01-22T08:57:07.000+01:00
This PR was squashed before being merged into the 4.2 branch (closes #10907). Discussion ---------- Document the multi-host DSN for Memcache caches Fixes #10402. Commits ------- 1ae951b Document the multi-host DSN for Memcache caches
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
