Proyectos de Subversion Moodle

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace cachestore_redis;

use cache_definition;
use cache_store;
use cachestore_redis;

defined('MOODLE_INTERNAL') || die();

require_once(__DIR__ . '/../../../tests/fixtures/stores.php');
require_once(__DIR__ . '/../lib.php');

/**
 * Redis cluster test.
 *
 * If you wish to use these unit tests all you need to do is add the following definition to
 * your config.php file:
 *
 * define('TEST_CACHESTORE_REDIS_SERVERSCLUSTER', 'localhost:7000,localhost:7001');
 * define('TEST_CACHESTORE_REDIS_ENCRYPTCLUSTER', true);
 * define('TEST_CACHESTORE_REDIS_AUTHCLUSTER', 'foobared');
 * define('TEST_CACHESTORE_REDIS_CASCLUSTER', '/cafile/dir/ca.crt');
 *
 * @package   cachestore_redis
 * @author    Daniel Thee Roperto <daniel.roperto@catalyst-au.net>
 * @copyright 2017 Catalyst IT Australia {@link http://www.catalyst-au.net}
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 *
 * @coversDefaultClass \cachestore_redis
 */
class cachestore_cluster_redis_test extends \advanced_testcase {
    /**
     * Create a cache store for testing the Redis cluster.
     *
     * @param string|null $seed The redis cluster servers.
     * @return cachestore_redis The created cache store instance.
     */
    public function create_store(?string $seed = null): cachestore_redis {
        global $DB;

        $definition = cache_definition::load_adhoc(
            mode: cache_store::MODE_APPLICATION,
            component: 'cachestore_redis',
            area: 'phpunit_test',
        );

        $servers = $seed ?? str_replace(",", "\n", TEST_CACHESTORE_REDIS_SERVERSCLUSTER);

        $config = [
            'server'      => $servers,
            'prefix'      => $DB->get_prefix(),
            'clustermode' => true,
        ];

        if (defined('TEST_CACHESTORE_REDIS_ENCRYPTCLUSTER') && TEST_CACHESTORE_REDIS_ENCRYPTCLUSTER === true) {
            $config['encryption'] = true;
        }
        if (defined('TEST_CACHESTORE_REDIS_AUTHCLUSTER') && TEST_CACHESTORE_REDIS_AUTHCLUSTER) {
            $config['password'] = TEST_CACHESTORE_REDIS_AUTHCLUSTER;
        }
        if (defined('TEST_CACHESTORE_REDIS_CASCLUSTER') && TEST_CACHESTORE_REDIS_CASCLUSTER) {
            $config['cafile'] = TEST_CACHESTORE_REDIS_CASCLUSTER;
        }

        $store = new cachestore_redis('TestCluster', $config);
        $store->initialise($definition);
        $store->purge();

        return $store;
    }

    /**
     * Set up the test environment.
     */
    public function setUp(): void {
        if (!cachestore_redis::are_requirements_met()) {
            $this->markTestSkipped('Could not test cachestore_redis with cluster, missing requirements.');
        } else if (!\cache_helper::is_cluster_available()) {
            $this->markTestSkipped('Could not test cachestore_redis with cluster, class RedisCluster is not available.');
        } else if (!defined('TEST_CACHESTORE_REDIS_SERVERSCLUSTER')) {
            $this->markTestSkipped('Could not test cachestore_redis with cluster, missing configuration. ' .
                                  "Example: define('TEST_CACHESTORE_REDIS_SERVERSCLUSTER', " .
                                  "'localhost:7000,localhost:7001,localhost:7002');");
        }
    }

    /**
     * Test if the cache store can be created successfully.
     *
     * @covers ::is_ready
     */
    public function test_it_can_create(): void {
        $store = $this->create_store();
        $this->assertNotNull($store);
        $this->assertTrue($store->is_ready());
    }

    /**
     * Test if the cache store trims server names correctly.
     *
     * @covers ::new_redis
     */
    public function test_it_trims_server_names(): void {
        // Add a time before and spaces after the first server. Also adds a blank line before second server.
        $servers = explode(',', TEST_CACHESTORE_REDIS_SERVERSCLUSTER);
        $servers[0] = "\t" . $servers[0] . "  \n";
        $servers = implode("\n", $servers);

        $store = $this->create_store($servers);

        $this->assertTrue($store->is_ready());
    }

    /**
     * Test if the cache store can successfully set and get a value.
     *
     * @covers ::set
     * @covers ::get
     */
    public function test_it_can_setget(): void {
        $store = $this->create_store();
        $store->set('the key', 'the value');
        $actual = $store->get('the key');

        $this->assertSame('the value', $actual);
    }

    /**
     * Test if the cache store can successfully set and get multiple values.
     *
     * @covers ::set_many
     * @covers ::get_many
     */
    public function test_it_can_setget_many(): void {
        $store = $this->create_store();

        // Create values.
        $values = [];
        $keys = [];
        $expected = [];
        for ($i = 0; $i < 10; $i++) {
            $key = "getkey_{$i}";
            $value = "getvalue #{$i}";
            $keys[] = $key;
            $values[] = [
                'key'   => $key,
                'value' => $value,
            ];
            $expected[$key] = $value;
        }

        $store->set_many($values);
        $actual = $store->get_many($keys);
        $this->assertSame($expected, $actual);
    }

    /**
     * Test if the cache store is marked as not ready if it fails to connect.
     *
     * @covers ::is_ready
     */
    public function test_it_is_marked_not_ready_if_failed_to_connect(): void {
        global $DB;

        $config = [
            'server'      => "abc:123",
            'prefix'      => $DB->get_prefix(),
            'clustermode' => true,
        ];
        $store = new cachestore_redis('TestCluster', $config);
        $debugging = $this->getDebuggingMessages();
        // Failed to connect should show a debugging message.
        $this->assertCount(1, \phpunit_util::get_debugging_messages() );
        $this->assertStringContainsString('Couldn\'t map cluster keyspace using any provided seed', $debugging[0]->message);
        $this->resetDebugging();
        $this->assertFalse($store->is_ready());
    }
}