CacheHashCalculatorTest.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Frontend\Tests\Unit\Page;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

class CacheHashCalculatorTest extends \TYPO3\CMS\Core\Tests\UnitTestCase
{
    protected $subject;

    protected $confCache = array();

    protected function setUp()
    {
        $this->confCache = array(
            'encryptionKey' => $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
        );
        $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey'] = 't3lib_cacheHashTest';
        $this->subject = $this->getMock(\TYPO3\CMS\Frontend\Page\CacheHashCalculator::class, array('foo'));
        $this->subject->setConfiguration(array(
            'excludedParameters' => array('exclude1', 'exclude2'),
            'cachedParametersWhiteList' => array(),
            'requireCacheHashPresenceParameters' => array('req1', 'req2'),
            'excludedParametersIfEmpty' => array(),
            'excludeAllEmptyParameters' => false
        ));
    }

    public function cacheHashCalculationWorks($params, $expected)
    {
        $this->assertEquals($expected, $this->subject->calculateCacheHash($params));
    }

    public function cacheHashCalculationDataprovider()
    {
        return array(
            'Empty parameters should not return a hash' => array(
                array(),
                ''
            ),
            'Trivial key value combination should generate hash' => array(
                array(
                    'encryptionKey' => 't3lib_cacheHashTest',
                    'key' => 'value'
                ),
                '5cfdcf826275558b3613dd51714a0a17'
            ),
            'Multiple parameters should generate hash' => array(
                array(
                    'a' => 'v',
                    'b' => 'v',
                    'encryptionKey' => 't3lib_cacheHashTest'
                ),
                '0f40b089cdad149aea99e9bf4badaa93'
            )
        );
    }

    public function getRelevantParametersWorks($params, $expected)
    {
        $actual = $this->subject->getRelevantParameters($params);
        $this->assertEquals($expected, array_keys($actual));
    }

    public function getRelevantParametersDataprovider()
    {
        return array(
            'Empty list should be passed through' => array('', array()),
            'Simple parameter should be passed through and the encryptionKey should be added' => array(
                'key=v',
                array('encryptionKey', 'key')
            ),
            'Simple parameter should be passed through' => array(
                'key1=v&key2=v',
                array('encryptionKey', 'key1', 'key2')
            ),
            'System and exclude parameters should be omitted' => array(
                'id=1&type=3&exclude1=x&no_cache=1',
                array()
            ),
            'System and exclude parameters should be omitted, others should stay' => array(
                'id=1&type=3&key=x&no_cache=1',
                array('encryptionKey', 'key')
            )
        );
    }

    public function canGenerateForParameters($params, $expected)
    {
        $this->assertEquals($expected, $this->subject->generateForParameters($params));
    }

    public function canGenerateForParametersDataprovider()
    {
        $knowHash = '5cfdcf826275558b3613dd51714a0a17';
        return array(
            'Empty parameters should not return an hash' => array('', ''),
            'Querystring has no relevant parameters so we should not have a cacheHash' => array('&exclude1=val', ''),
            'Querystring has only system parameters so we should not have a cacheHash' => array('id=1&type=val', ''),
            'Trivial key value combination should generate hash' => array('&key=value', $knowHash),
            'Only the relevant parts should be taken into account' => array('&key=value&exclude1=val', $knowHash),
            'Only the relevant parts should be taken into account(exclude2 before key)' => array('&exclude2=val&key=value', $knowHash),
            'System parameters should not be taken into account' => array('&id=1&key=value', $knowHash),
            'Admin panel parameters should not be taken into account' => array('&TSFE_ADMIN_PANEL[display]=7&key=value', $knowHash),
            'Trivial hash for sorted parameters should be right' => array('a=v&b=v', '0f40b089cdad149aea99e9bf4badaa93'),
            'Parameters should be sorted before  is created' => array('b=v&a=v', '0f40b089cdad149aea99e9bf4badaa93')
        );
    }

    public function parametersRequireCacheHashWorks($params, $expected)
    {
        $this->assertEquals($expected, $this->subject->doParametersRequireCacheHash($params));
    }

    public function parametersRequireCacheHashDataprovider()
    {
        return array(
            'Empty parameter strings should not require anything.' => array('', false),
            'Normal parameters aren\'t required.' => array('key=value', false),
            'Configured "req1" to be required.' => array('req1=value', true),
            'Configured "req1" to be required, should also work in combined context' => array('&key=value&req1=value', true),
            'Configured "req1" to be required, should also work in combined context (key at the end)' => array('req1=value&key=value', true)
        );
    }

    public function canWhitelistParameters($params, $expected)
    {
        $method = new \ReflectionMethod(\TYPO3\CMS\Frontend\Page\CacheHashCalculator::class, 'setCachedParametersWhiteList');
        $method->setAccessible(true);
        $method->invoke($this->subject, array('whitep1', 'whitep2'));
        $this->assertEquals($expected, $this->subject->generateForParameters($params));
    }

    public function canWhitelistParametersDataprovider()
    {
        $oneParamHash = 'e2c0f2edf08be18bcff2f4272e11f66b';
        $twoParamHash = 'f6f08c2e10a97d91b6ec61a6e2ddd0e7';
        return array(
            'Even with the whitelist enabled, empty parameters should not return an hash.' => array('', ''),
            'Whitelisted parameters should have a hash.' => array('whitep1=value', $oneParamHash),
            'Blacklisted parameter should not influence hash.' => array('whitep1=value&black=value', $oneParamHash),
            'Multiple whitelisted parameters should work' => array('&whitep1=value&whitep2=value', $twoParamHash),
            'The order should not influce the hash.' => array('whitep2=value&black=value&whitep1=value', $twoParamHash)
        );
    }

    public function canSkipParametersWithEmptyValues($params, $settings, $expected)
    {
        $this->subject->setConfiguration($settings);
        $actual = $this->subject->getRelevantParameters($params);
        $this->assertEquals($expected, array_keys($actual));
    }

    public function canSkipParametersWithEmptyValuesDataprovider()
    {
        return array(
            'The default configuration does not allow to skip an empty key.' => array(
                'key1=v&key2=&key3=',
                array('excludedParametersIfEmpty' => array(), 'excludeAllEmptyParameters' => false),
                array('encryptionKey', 'key1', 'key2', 'key3')
            ),
            'Due to the empty value, "key2" should be skipped(with equals sign' => array(
                'key1=v&key2=&key3=',
                array('excludedParametersIfEmpty' => array('key2'), 'excludeAllEmptyParameters' => false),
                array('encryptionKey', 'key1', 'key3')
            ),
            'Due to the empty value, "key2" should be skipped(without equals sign)' => array(
                'key1=v&key2&key3',
                array('excludedParametersIfEmpty' => array('key2'), 'excludeAllEmptyParameters' => false),
                array('encryptionKey', 'key1', 'key3')
            ),
            'Due to the empty value, "key2" and "key3" should be skipped' => array(
                'key1=v&key2=&key3=',
                array('excludedParametersIfEmpty' => array(), 'excludeAllEmptyParameters' => true),
                array('encryptionKey', 'key1')
            )
        );
    }
}