CacheTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\Core\Cache;

use Drupal\Core\Cache\Cache;
use Drupal\Tests\Core\Database\Stub\Select;
use Drupal\Tests\Core\Database\Stub\StubConnection;
use Drupal\Tests\Core\Database\Stub\StubPDO;
use Drupal\Tests\UnitTestCase;
use Prophecy\Argument;
use Drupal\Core\Cache\Context\CacheContextsManager;
use Drupal\Core\DependencyInjection\Container;

/**
 * @coversDefaultClass \Drupal\Core\Cache\Cache
 * @group Cache
 */
class CacheTest extends UnitTestCase {
    
    /**
     * Provides a list of cache tags arrays.
     *
     * @return array
     */
    public function validateTagsProvider() {
        return [
            [
                [],
                FALSE,
            ],
            [
                [
                    'foo',
                ],
                FALSE,
            ],
            [
                [
                    'foo',
                    'bar',
                ],
                FALSE,
            ],
            [
                [
                    'foo',
                    'bar',
                    'llama:2001988',
                    'baz',
                    'llama:14031991',
                ],
                FALSE,
            ],
            // Invalid.
[
                [
                    FALSE,
                ],
                'Cache tags must be strings, boolean given.',
            ],
            [
                [
                    TRUE,
                ],
                'Cache tags must be strings, boolean given.',
            ],
            [
                [
                    'foo',
                    FALSE,
                ],
                'Cache tags must be strings, boolean given.',
            ],
            [
                [
                    NULL,
                ],
                'Cache tags must be strings, NULL given.',
            ],
            [
                [
                    'foo',
                    NULL,
                ],
                'Cache tags must be strings, NULL given.',
            ],
            [
                [
                    1337,
                ],
                'Cache tags must be strings, integer given.',
            ],
            [
                [
                    'foo',
                    1337,
                ],
                'Cache tags must be strings, integer given.',
            ],
            [
                [
                    3.14,
                ],
                'Cache tags must be strings, double given.',
            ],
            [
                [
                    'foo',
                    3.14,
                ],
                'Cache tags must be strings, double given.',
            ],
            [
                [
                    [],
                ],
                'Cache tags must be strings, array given.',
            ],
            [
                [
                    'foo',
                    [],
                ],
                'Cache tags must be strings, array given.',
            ],
            [
                [
                    'foo',
                    [
                        'bar',
                    ],
                ],
                'Cache tags must be strings, array given.',
            ],
            [
                [
                    new \stdClass(),
                ],
                'Cache tags must be strings, object given.',
            ],
            [
                [
                    'foo',
                    new \stdClass(),
                ],
                'Cache tags must be strings, object given.',
            ],
        ];
    }
    
    /**
     * Provides a list of pairs of cache tags arrays to be merged.
     *
     * @return array
     */
    public static function mergeTagsProvider() {
        return [
            [
                [],
                [],
                [],
            ],
            [
                [
                    'bar',
                    'foo',
                ],
                [
                    'bar',
                ],
                [
                    'foo',
                ],
            ],
            [
                [
                    'foo',
                    'bar',
                ],
                [
                    'foo',
                ],
                [
                    'bar',
                ],
            ],
            [
                [
                    'foo',
                    'bar',
                ],
                [
                    'foo',
                ],
                [
                    'bar',
                    'foo',
                ],
            ],
            [
                [
                    'foo',
                    'bar',
                ],
                [
                    'foo',
                ],
                [
                    'foo',
                    'bar',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                ],
                [
                    'bar',
                    'foo',
                ],
                [
                    'foo',
                    'bar',
                ],
            ],
            [
                [
                    'foo',
                    'bar',
                ],
                [
                    'foo',
                    'bar',
                ],
                [
                    'foo',
                    'bar',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                    'llama',
                ],
                [
                    'bar',
                    'foo',
                ],
                [
                    'foo',
                    'bar',
                ],
                [
                    'llama',
                    'foo',
                ],
            ],
        ];
    }
    
    /**
     * @covers ::mergeTags
     *
     * @dataProvider mergeTagsProvider
     */
    public function testMergeTags(array $expected, ...$cache_tags) : void {
        $this->assertEqualsCanonicalizing($expected, Cache::mergeTags(...$cache_tags));
    }
    
    /**
     * Provides a list of pairs of cache tags arrays to be merged.
     *
     * @return array
     */
    public static function mergeMaxAgesProvider() {
        return [
            [
                Cache::PERMANENT,
                Cache::PERMANENT,
                Cache::PERMANENT,
            ],
            [
                60,
                60,
                60,
            ],
            [
                0,
                0,
                0,
            ],
            [
                0,
                60,
                0,
            ],
            [
                0,
                0,
                60,
            ],
            [
                0,
                Cache::PERMANENT,
                0,
            ],
            [
                0,
                0,
                Cache::PERMANENT,
            ],
            [
                60,
                Cache::PERMANENT,
                60,
            ],
            [
                60,
                60,
                Cache::PERMANENT,
            ],
            [
                Cache::PERMANENT,
                Cache::PERMANENT,
                Cache::PERMANENT,
                Cache::PERMANENT,
            ],
            [
                30,
                60,
                60,
                30,
            ],
            [
                0,
                0,
                0,
                0,
            ],
            [
                60,
                Cache::PERMANENT,
                60,
                Cache::PERMANENT,
            ],
            [
                60,
                60,
                Cache::PERMANENT,
                Cache::PERMANENT,
            ],
            [
                60,
                Cache::PERMANENT,
                Cache::PERMANENT,
                60,
            ],
        ];
    }
    
    /**
     * @covers ::mergeMaxAges
     *
     * @dataProvider mergeMaxAgesProvider
     */
    public function testMergeMaxAges($expected, ...$max_ages) : void {
        $this->assertSame($expected, Cache::mergeMaxAges(...$max_ages));
    }
    
    /**
     * Provides a list of pairs of cache contexts arrays to be merged.
     *
     * @return array
     */
    public static function mergeCacheContextsProvide() {
        return [
            [
                [],
                [],
                [],
            ],
            [
                [
                    'foo',
                ],
                [],
                [
                    'foo',
                ],
            ],
            [
                [
                    'foo',
                ],
                [
                    'foo',
                ],
                [],
            ],
            [
                [
                    'bar',
                    'foo',
                ],
                [
                    'foo',
                ],
                [
                    'bar',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                ],
                [
                    'bar',
                ],
                [
                    'foo',
                ],
            ],
            [
                [
                    'foo.bar',
                    'foo.foo',
                ],
                [
                    'foo.foo',
                ],
                [
                    'foo.bar',
                ],
            ],
            [
                [
                    'foo.bar',
                    'foo.foo',
                ],
                [
                    'foo.bar',
                ],
                [
                    'foo.foo',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                    'llama',
                ],
                [],
                [
                    'foo',
                    'bar',
                    'llama',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                    'llama',
                ],
                [
                    'foo',
                    'bar',
                    'llama',
                ],
                [],
            ],
            [
                [
                    'bar',
                    'foo',
                    'llama',
                ],
                [
                    'foo',
                ],
                [
                    'foo',
                    'bar',
                    'llama',
                ],
            ],
            [
                [
                    'bar',
                    'foo',
                    'llama',
                ],
                [
                    'foo',
                    'bar',
                    'llama',
                ],
                [
                    'foo',
                ],
            ],
        ];
    }
    
    /**
     * @covers ::mergeContexts
     *
     * @dataProvider mergeCacheContextsProvide
     */
    public function testMergeCacheContexts(array $expected, ...$contexts) : void {
        $cache_contexts_manager = $this->prophesize(CacheContextsManager::class);
        $cache_contexts_manager->assertValidTokens(Argument::any())
            ->willReturn(TRUE);
        $container = $this->prophesize(Container::class);
        $container->get('cache_contexts_manager')
            ->willReturn($cache_contexts_manager->reveal());
        \Drupal::setContainer($container->reveal());
        $this->assertEqualsCanonicalizing($expected, Cache::mergeContexts(...$contexts));
    }
    
    /**
     * Provides a list of pairs of (prefix, suffixes) to build cache tags from.
     *
     * @return array
     */
    public static function buildTagsProvider() {
        return [
            [
                'node',
                [
                    1,
                ],
                [
                    'node:1',
                ],
            ],
            [
                'node',
                [
                    1,
                    2,
                    3,
                ],
                [
                    'node:1',
                    'node:2',
                    'node:3',
                ],
            ],
            [
                'node',
                [
                    3,
                    2,
                    1,
                ],
                [
                    'node:3',
                    'node:2',
                    'node:1',
                ],
            ],
            [
                'node',
                [
                    NULL,
                ],
                [
                    'node:',
                ],
            ],
            [
                'node',
                [
                    TRUE,
                    FALSE,
                ],
                [
                    'node:1',
                    'node:',
                ],
            ],
            [
                'node',
                [
                    'a',
                    'z',
                    'b',
                ],
                [
                    'node:a',
                    'node:z',
                    'node:b',
                ],
            ],
            // No suffixes, no cache tags.
[
                '',
                [],
                [],
            ],
            [
                'node',
                [],
                [],
            ],
            // Only suffix values matter, not keys: verify that expectation.
[
                'node',
                [
                    5 => 145,
                    4545 => 3,
                ],
                [
                    'node:145',
                    'node:3',
                ],
            ],
            [
                'node',
                [
                    5 => TRUE,
                ],
                [
                    'node:1',
                ],
            ],
            [
                'node',
                [
                    5 => NULL,
                ],
                [
                    'node:',
                ],
            ],
            [
                'node',
                [
                    'a' => NULL,
                ],
                [
                    'node:',
                ],
            ],
            [
                'node',
                [
                    'a' => TRUE,
                ],
                [
                    'node:1',
                ],
            ],
            // Test the $glue parameter.
[
                'config:system.menu',
                [
                    'menu_name',
                ],
                [
                    'config:system.menu.menu_name',
                ],
                '.',
            ],
        ];
    }
    
    /**
     * @covers ::buildTags
     *
     * @dataProvider buildTagsProvider
     */
    public function testBuildTags($prefix, array $suffixes, array $expected, $glue = ':') : void {
        $this->assertEquals($expected, Cache::buildTags($prefix, $suffixes, $glue));
    }
    
    /**
     * @covers ::keyFromQuery
     * @group legacy
     */
    public function testKeyFromQuery() : void {
        $this->expectDeprecation('Drupal\\Core\\Cache\\Cache::keyFromQuery is deprecated in drupal:10.1.0 and is removed from drupal:11.0.0. No replacement provided. See https://www.drupal.org/node/3322044');
        $query = new Select(new StubConnection(new StubPDO(), []), 'dne');
        Cache::keyFromQuery($query);
    }

}