XC_VM/src/Core/Cache/RedisCache.php

<?php

use XcVm\Core\Container\ServiceContainer;
/**
 * Redis Cache Driver
 *
 * Redis-based cache driver implementing CacheInterface.
 * Wraps the phpredis extension with serialization and TTL support.
 *
 * ServiceContainer Registration:
 *
 *   $container->set('redis', function($c) {
 *       $settings = $c->get('settings');
 *       $config   = $c->get('config');
 *       return new RedisCache(
 *           $config['hostname'],
 *           6379,
 *           $settings['redis_password']
 *       );
 *   });
 *
 * Raw Redis Access:
 *
 *   During migration, legacy code may need raw Redis:
 *     $rawRedis = $redisCache->getConnection();
 *     $rawRedis->multi();
 *     $rawRedis->zAdd('LIVE', $timestamp, $uuid);
 *     $rawRedis->exec();
 *
 * @see CacheInterface
 * @see RedisManager::ensureConnected()
 *
 * @package XC_VM_Core_Cache
 * @author  Divarion_D <https://github.com/Divarion-D>
 * @copyright 2025-2026 Vateron Media
 * @link    https://github.com/Vateron-Media/XC_VM
 * @license AGPL-3.0 https://www.gnu.org/licenses/agpl-3.0.html
 */

class RedisCache implements CacheInterface {

    /** @var Redis|null phpredis connection */
    protected $redis = null;

    /** @var string Redis host */
    protected $host;

    /** @var int Redis port */
    protected $port;

    /** @var string|null Redis password */
    protected $password;

    /** @var bool Whether connection is established */
    protected $connected = false;

    /** @var string Key prefix to avoid collisions */
    protected $prefix = '';

    /**
     * @param string $host Redis host
     * @param int $port Redis port
     * @param string|null $password Redis AUTH password
     * @param string $prefix Optional key prefix
     */
    public function __construct($host = '127.0.0.1', $port = 6379, $password = null, $prefix = '') {
        $this->host = $host;
        $this->port = $port;
        $this->password = $password;
        $this->prefix = $prefix;
    }

    /**
     * Establish Redis connection (lazy — called on first operation)
     *
     * @return bool
     */
    public function connect() {
        if ($this->connected && $this->redis !== null) {
            return true;
        }

        try {
            $this->redis = new \Redis();
            $this->redis->connect($this->host, $this->port);

            if ($this->password) {
                $this->redis->auth($this->password);
            }

            // Use igbinary serializer if available for consistency with FileCache
            if (defined('Redis::SERIALIZER_IGBINARY')) {
                $this->redis->setOption(\Redis::OPT_SERIALIZER, \Redis::SERIALIZER_IGBINARY);
            }

            $this->connected = true;
            return true;
        } catch (\Exception $e) {
            $this->redis = null;
            $this->connected = false;
            return false;
        }
    }

    /**
     * {@inheritdoc}
     */
    public function get($key, $maxAge = null) {
        if (!$this->ensureConnected()) {
            return false;
        }

        $prefixedKey = $this->prefix . $key;
        $data = $this->redis->get($prefixedKey);

        if ($data === false) {
            return false;
        }

        // maxAge is handled by Redis TTL, not by us
        // But if caller wants to check age, we can't — Redis doesn't store creation time
        // For file-based TTL compat, we ignore maxAge here (Redis uses its own TTL)

        return $data;
    }

    /**
     * {@inheritdoc}
     */
    public function set($key, $data, $ttl = 0) {
        if (!$this->ensureConnected()) {
            return false;
        }

        $prefixedKey = $this->prefix . $key;

        if ($ttl > 0) {
            return $this->redis->setex($prefixedKey, $ttl, $data);
        }

        return $this->redis->set($prefixedKey, $data);
    }

    /**
     * {@inheritdoc}
     */
    public function delete($key) {
        if (!$this->ensureConnected()) {
            return false;
        }

        $prefixedKey = $this->prefix . $key;
        $this->redis->del($prefixedKey);

        return true;
    }

    /**
     * {@inheritdoc}
     */
    public function has($key, $maxAge = null) {
        if (!$this->ensureConnected()) {
            return false;
        }

        $prefixedKey = $this->prefix . $key;

        return (bool) $this->redis->exists($prefixedKey);
    }

    /**
     * {@inheritdoc}
     *
     * WARNING: Flushes the ENTIRE Redis database. Use with caution.
     */
    public function flush() {
        if (!$this->ensureConnected()) {
            return false;
        }

        return $this->redis->flushDB();
    }

    // ───────────────────────────────────────────────────────────
    //  Raw Redis Access (for migration period)
    // ───────────────────────────────────────────────────────────

    /**
     * Get the raw phpredis connection
     *
     * Allows legacy code to use Redis-specific operations (sorted sets,
     * pipelines, pub/sub, etc.) that don't fit the CacheInterface.
     *
     * @return Redis|null
     */
    public function getConnection() {
        $this->ensureConnected();
        return $this->redis;
    }

    /**
     * Check if connection is alive
     *
     * @return bool
     */
    public function isConnected() {
        if (!$this->connected || !$this->redis) {
            return false;
        }

        try {
            return $this->redis->ping() !== false;
        } catch (\Exception $e) {
            $this->connected = false;
            return false;
        }
    }

    /**
     * Close connection
     */
    public function disconnect() {
        if ($this->redis) {
            try {
                $this->redis->close();
            } catch (\Exception $e) {
                // ignore
            }
        }

        $this->redis = null;
        $this->connected = false;
    }

    /**
     * Ensure connection is active, reconnect if needed
     *
     * @return bool
     */
    protected function ensureConnected() {
        if ($this->connected && $this->redis !== null) {
            return true;
        }

        return $this->connect();
    }

    /**
     * Disconnect from Redis when the instance is destroyed.
     */
    public function __destruct() {
        $this->disconnect();
    }
}