<?php
/**
 * Redis/Valkey Caching Configuration for Nextcloud
 * 
 * This file provides Redis caching for Nextcloud application-level operations
 * (distributed cache, file locking) WITHOUT enabling Redis for PHP sessions.
 * 
 * IMPORTANT: This overrides the default /usr/src/nextcloud/config/redis.config.php
 * which checks for REDIS_HOST environment variable. We deploy this custom version
 * to enable Redis caching while keeping PHP sessions file-based for stability.
 * 
 * Why not use REDIS_HOST env var?
 * - Setting REDIS_HOST enables BOTH Redis sessions AND Redis caching
 * - Redis session handling can cause severe performance issues:
 *   * Session lock contention under high concurrency
 *   * Infinite lock retries blocking FPM workers
 *   * Timeout orphaning leaving locks unreleased
 *   * Worker pool exhaustion causing cascading failures
 * 
 * This configuration provides the benefits of Redis caching (fast distributed
 * cache, reliable file locking) while avoiding the pitfalls of Redis sessions.
 * 
 * Managed by: Ansible Nextcloud role
 * Template: roles/nextcloud/templates/redis.config.php.j2
 */

$CONFIG = array(
  'memcache.distributed' => '\OC\Memcache\Redis',
  'memcache.locking' => '\OC\Memcache\Redis',
  'redis' => array(
    'host' => '{{ valkey_unix_socket_path }}',
    'password' => '{{ valkey_password }}',
  ),
);