chore(administration): Generate system config documentation from config.sample.php

Author: nextcloud-bot

admin_manual/configuration_server/config_sample_php_parameters.rst

@@ -2809,6 +2809,96 @@ Cache Key Prefix for Redis or Memcached
 
 Defaults to ``''`` (empty string)
 
+memcache.kvstore
+^^^^^^^^^^^^^^^^
+
+
+::
+
+    'memcache.kvstore' => [
+
+Connection details for the Key-Value store used for in-memory caching,
+for example when using Valkey or Redis.
+
+This is the brand-independent successor of the ``redis`` and
+``redis.cluster`` options below and supports the latest Valkey and Redis
+releases. Three topologies are supported:
+a single server, a Sentinel managed replication set, and a
+server cluster. Configure exactly one of ``server``, ``sentinel`` or
+``seeds``.
+
+For enhanced security, it is recommended to configure ACLs in
+the cache server and configure the ``user`` and ``password`` (or a TLS
+client certificate). Alternatively, you can also configure the cache
+server to just use a ``password``.
+See https://valkey.io/topics/security/ for more information when using Valkey.
+
+server
+^^^^^^
+
+
+::
+
+    'server' => [
+                'host' => 'localhost', // can also be a Unix domain socket: '/tmp/cache.sock'
+                'port' => 6379, // ignored for Unix domain sockets
+                // Protocol used to connect. One of 'tcp', 'tls' or 'unix'.
+                // When omitted it is derived from the host (a leading '/' means 'unix').
+                'protocol' => 'tcp',
+            ],
+
+Single server setup.
+
+Also used as the connection template for the ``sentinel`` managed
+primary / replica connections.
+
+Sentinel managed replication setup.
+-----------------------------------
+
+Provide the name of the monitored service and one entry per Sentinel
+node. Each seed uses the same format as the ``server`` entry above.
+Uncomment to enable and remove the ``server`` / ``seeds`` entries.
+
+
+user
+^^^^
+
+
+::
+
+    //'seeds' => [
+            //    ['host' => 'localhost', 'port' => 7000],
+            //    ['host' => 'localhost', 'port' => 7001],
+            //],
+
+            // Optional: username, only sent when the cache server uses ACLs.
+            'user' => '',
+            // Optional: if not defined, no password will be used.
+            'password' => '',
+            // Optional: select a numbered database. Only supported for single
+            // servers and Sentinel setups, clusters always use database 0.
+            'dbindex' => 0,
+            // Optional: connection timeout in seconds (float). 0 means no timeout.
+            'timeout' => 0.0,
+            // Optional: read/write timeout in seconds (float). 0 means no timeout.
+            'read_timeout' => 0.0,
+            // Optional: keep the connection open across requests. Defaults to false.
+            'persistent' => false,
+            // Optional: when the 'tls' protocol is used, provide the SSL context.
+            // SSL context options, see https://www.php.net/manual/en/context.ssl.php
+            //'ssl_context' => [
+            //    'local_cert' => '/certs/cache.crt',
+            //    'local_pk' => '/certs/cache.key',
+            //    'cafile' => '/certs/ca.crt',
+            //],
+        ],
+
+Cluster setup.
+
+Provide some or all of the cluster nodes to bootstrap discovery.
+Each seed uses the same format as the ``server`` entry above.
+Uncomment to enable and remove the ``server`` / ``sentinel`` entries.
+
 redis
 ^^^^^
 
@@ -2841,6 +2931,8 @@ for more information.
 We also support Redis SSL/TLS encryption as of version 6.
 See https://redis.io/topics/encryption for more information.
 
+.. deprecated:: 34.0.0 use `memcache.kvstore` instead which supports also Valkey.
+
 redis.cluster
 ^^^^^^^^^^^^^
 
@@ -2891,6 +2983,8 @@ See https://redis.io/topics/cluster-spec for details about the Redis cluster
 Authentication works with phpredis version 4.2.1+. See
 https://github.com/phpredis/phpredis/commit/c5994f2a42b8a348af92d3acb4edff1328ad8ce1
 
+.. deprecated:: 34.0.0 use `memcache.kvstore` instead which supports also Valkey.
+
 memcached_servers
 ^^^^^^^^^^^^^^^^^