LockerTest.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Tests\Unit\Locking;

/*
 * 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!
 */

use TYPO3\CMS\Core\Locking\Locker;

class LockerTest extends \TYPO3\CMS\Core\Tests\UnitTestCase
{
    // tests concerning __construct

    public function constructorUsesDefaultLockingMethodSimple()
    {
        $instance = new Locker('999999999');
        $this->assertSame(Locker::LOCKING_METHOD_SIMPLE, $instance->getMethod());
    }

    public function constructorSetsMethodToGivenParameter()
    {
        $instance = new Locker('999999999', Locker::LOCKING_METHOD_FLOCK);
        $this->assertSame(Locker::LOCKING_METHOD_FLOCK, $instance->getMethod());
    }

    public function constructorThrowsExceptionForNotExistingLockingMethod()
    {
        new Locker('999999999', 'foo');
    }

    public function constructorFetchesInstallToolConfigurationIfEmptyMethod()
    {
        $GLOBALS['TYPO3_CONF_VARS']['SYS']['lockingMode'] = Locker::LOCKING_METHOD_SIMPLE;
        $instance = new Locker('999999999', '');
        $this->assertSame(Locker::LOCKING_METHOD_SIMPLE, $instance->getMethod());
    }

    public function constructorUsesDefaultValueForLoops()
    {
        $instance = $this->getAccessibleMock(\TYPO3\CMS\Core\Locking\Locker::class, ['dummy'], ['999999999', Locker::LOCKING_METHOD_DISABLED]);
        $this->assertSame(150, $instance->_get('loops'));
    }

    public function constructorSetsLoopsToGivenNumberOfLoops()
    {
        $instance = $this->getAccessibleMock(\TYPO3\CMS\Core\Locking\Locker::class, ['dummy'], ['999999999', Locker::LOCKING_METHOD_DISABLED, 10]);
        $this->assertSame(10, $instance->_get('loops'));
    }

    public function constructorUsesDefaultValueForSteps()
    {
        $instance = $this->getAccessibleMock(\TYPO3\CMS\Core\Locking\Locker::class, ['dummy'], ['999999999', Locker::LOCKING_METHOD_DISABLED]);
        $this->assertSame(200, $instance->_get('step'));
    }

    public function constructorSetsStepToGivenNumberOfStep()
    {
        $instance = $this->getAccessibleMock(\TYPO3\CMS\Core\Locking\Locker::class, ['dummy'], ['999999999', Locker::LOCKING_METHOD_DISABLED, 0, 10]);
        $this->assertSame(10, $instance->_get('step'));
    }

    public function constructorCreatesLockDirectoryIfNotExisting()
    {
        \TYPO3\CMS\Core\Utility\GeneralUtility::rmdir(PATH_site . Locker::FILE_LOCK_FOLDER, true);
        new Locker('999999999', Locker::LOCKING_METHOD_SIMPLE);
        $this->assertTrue(is_dir(PATH_site . Locker::FILE_LOCK_FOLDER));
    }

    public function constructorSetsIdToMd5OfStringIfUsingSimpleLocking()
    {
        $instance = new Locker('999999999', Locker::LOCKING_METHOD_SIMPLE);
        $this->assertSame(md5('999999999'), $instance->getId());
    }

    public function constructorSetsResourceToPathWithIdIfUsingSimpleLocking()
    {
        $instance = new Locker('999999999', Locker::LOCKING_METHOD_SIMPLE);
        $this->assertSame(PATH_site . Locker::FILE_LOCK_FOLDER . md5('999999999'), $instance->getResource());
    }

    public function constructorSetsIdToAbsCrc32OfIdStringIfUsingSemaphoreLocking()
    {
        if (!function_exists('sem_get')) {
            $this->markTestSkipped('The system does not support semaphore base locking.');
        }
        $instance = new Locker('999999999', Locker::LOCKING_METHOD_SEMAPHORE);
        $this->assertSame(abs(crc32('999999999')), $instance->getId());
    }

    // tests concerning acquire

    public function acquireFixesPermissionsOnLockFileIfUsingSimpleLogging()
    {
        if (TYPO3_OS == 'WIN') {
            $this->markTestSkipped('acquireFixesPermissionsOnLockFileIfUsingSimpleLogging() test not available on Windows.');
        }
        // Use a very high id to be unique
        $instance = new Locker(999999999, Locker::LOCKING_METHOD_SIMPLE);
        $instance->setEnableLogging(false);
        $pathOfLockFile = $instance->getResource();
        $GLOBALS['TYPO3_CONF_VARS']['SYS']['fileCreateMask'] = '0777';
        // Acquire lock, get actual file permissions and clean up
        $instance->acquireExclusiveLock();
        clearstatcache();
        $resultFilePermissions = substr(decoct(fileperms($pathOfLockFile)), 2);
        $instance->release();
        $this->assertEquals($resultFilePermissions, '0777');
    }

    // tests concerning release

    public function releaseRemovesLockfileInTypo3TempLocks()
    {
        // Use a very high id to be unique
        $instance = new Locker(999999999, Locker::LOCKING_METHOD_SIMPLE);
        // Disable logging
        $instance->setEnableLogging(false);
        // File pointer to current lock file
        $lockFile = $instance->getResource();
        $instance->acquireExclusiveLock();
        $instance->release();
        $this->assertFalse(is_file($lockFile));
    }

    public function invalidFileReferences()
    {
        return [
            'simple not within PATH_site' => ['simple', '/tmp/TYPO3-Lock-Test'],
            'flock not withing PATH_site' => ['flock', '/tmp/TYPO3-Lock-Test'],
            'simple directory traversal' => ['simple', PATH_site . 'typo3temp/../typo3temp/locks/foo'],
            'flock directory traversal' => ['flock', PATH_site . 'typo3temp/../typo3temp/locks/foo'],
            'simple directory traversal 2' => ['simple', PATH_site . 'typo3temp/locks/../locks/foo'],
            'flock directory traversal 2' => ['flock', PATH_site . 'typo3temp/locks/../locks/foo'],
            'simple within uploads' => ['simple', PATH_site . 'uploads/TYPO3-Lock-Test'],
            'flock within uploads' => ['flock', PATH_site . 'uploads/TYPO3-Lock-Test']
        ];
    }

    public function releaseDoesNotRemoveFilesNotWithinTypo3TempLocksDirectory($lockMethod, $file)
    {
        if (TYPO3_OS === 'WIN') {
            $this->markTestSkipped('releaseDoesNotRemoveFilesNotWithinTypo3TempLocksDirectory() test not available on Windows.');
        }
        // Create test file
        touch($file);
        if (!is_file($file)) {
            $this->markTestSkipped('releaseDoesNotRemoveFilesNotWithinTypo3TempLocksDirectory() skipped: Test file could not be created');
        }
        // Create instance, set lockfile to invalid path
        $instance = new Locker(999999999, $lockMethod);
        $instance->setEnableLogging(false);
        $t3libLockReflection = new \ReflectionClass(\TYPO3\CMS\Core\Locking\Locker::class);
        $t3libLockReflectionResourceProperty = $t3libLockReflection->getProperty('resource');
        $t3libLockReflectionResourceProperty->setAccessible(true);
        $t3libLockReflectionResourceProperty->setValue($instance, $file);
        $t3libLockReflectionAcquiredProperty = $t3libLockReflection->getProperty('isAcquired');
        $t3libLockReflectionAcquiredProperty->setAccessible(true);
        $t3libLockReflectionAcquiredProperty->setValue($instance, true);
        // Call release method
        $instance->release();
        // Check if file is still there and clean up
        $fileExists = is_file($file);
        if (is_file($file)) {
            unlink($file);
        }
        $this->assertTrue($fileExists);
    }
}