FileLockStrategy.php

Go to the documentation of this file.

<?php
 
/*
 * 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!
 */
 
namespace ‪TYPO3\CMS\Core\Locking;
 
use ‪TYPO3\CMS\Core\Core\Environment;
use ‪TYPO3\CMS\Core\Locking\Exception\LockAcquireException;
use ‪TYPO3\CMS\Core\Locking\Exception\LockAcquireWouldBlockException;
use ‪TYPO3\CMS\Core\Locking\Exception\LockCreateException;
use ‪TYPO3\CMS\Core\Security\BlockSerializationTrait;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪FileLockStrategy implements ‪LockingStrategyInterface
{
    use ‪BlockSerializationTrait;
 
    const ‪FILE_LOCK_FOLDER = 'lock/';
    const ‪DEFAULT_PRIORITY = 75;
 
    protected ‪$filePointer;
 
    protected ‪$filePath;
 
    protected ‪$isAcquired = false;
 
    public function ‪__construct($subject)
    {
        /*
         * Tests if the directory for file locks is available.
         * If not, the directory will be created. The lock path is usually
         * below typo3temp/var, typo3temp/var itself should exist already (or root-path/var/ respectively)
         */
        if (‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][self::class]['lockFileDir'] ?? false) {
            $path = ‪Environment::getProjectPath() . '/'
                . trim(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][self::class]['lockFileDir'], ' /')
                . '/';
        } else {
            $path = ‪Environment::getVarPath() . '/' . ‪self::FILE_LOCK_FOLDER;
        }
        if (!is_dir($path)) {
            // Not using mkdir_deep on purpose here, if typo3temp itself
            // does not exist, this issue should be solved on a different
            // level of the application.
            if (!‪GeneralUtility::mkdir($path)) {
                throw new ‪LockCreateException('Cannot create directory ' . $path, 1395140007);
            }
        }
        if (!is_writable($path)) {
            throw new ‪LockCreateException('Cannot write to directory ' . $path, 1396278700);
        }
        $this->filePath = $path . 'flock_' . md5((string)$subject);
    }
 
    public function ‪__destruct()
    {
        $this->‪release();
    }
 
    public function ‪acquire($mode = self::LOCK_CAPABILITY_EXCLUSIVE)
    {
        if ($this->‪isAcquired) {
            return true;
        }
 
        $this->filePointer = fopen($this->filePath, 'c');
        if ($this->filePointer === false) {
            throw new LockAcquireException('Lock file could not be opened', 1294586099);
        }
        ‪GeneralUtility::fixPermissions($this->filePath);
 
        $operation = $mode & self::LOCK_CAPABILITY_EXCLUSIVE ? LOCK_EX : LOCK_SH;
        if ($mode & self::LOCK_CAPABILITY_NOBLOCK) {
            $operation |= LOCK_NB;
        }
 
        $wouldBlock = 0;
        $this->‪isAcquired = flock($this->filePointer, $operation, $wouldBlock);
 
        if (!$this->‪isAcquired) {
            // Make sure to cleanup any dangling resources for this process/thread, which are not needed any longer
            fclose($this->filePointer);
        }
        if ($mode & self::LOCK_CAPABILITY_NOBLOCK && !$this->‪isAcquired && $wouldBlock) {
            throw new LockAcquireWouldBlockException('Failed to acquire lock because the request would block.', 1428700748);
        }
 
        return ‪$this->isAcquired;
    }
 
    public function ‪release()
    {
        if (!$this->‪isAcquired) {
            return true;
        }
        $success = true;
        if (is_resource($this->filePointer)) {
            if (flock($this->filePointer, LOCK_UN) === false) {
                $success = false;
            }
            fclose($this->filePointer);
        }
        $this->‪isAcquired = false;
        return $success;
    }
 
    public function ‪isAcquired()
    {
        return ‪$this->isAcquired;
    }
 
    public static function ‪getPriority()
    {
        return ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][self::class]['priority']
            ?? ‪self::DEFAULT_PRIORITY;
    }
 
    public static function ‪getCapabilities()
    {
        if (PHP_SAPI === 'isapi') {
            // From php docs: When using a multi-threaded server API like ISAPI you may not be able to rely on flock()
            // to protect files against other PHP scripts running in parallel threads of the same server instance!
            return 0;
        }
        $capabilities = self::LOCK_CAPABILITY_EXCLUSIVE | self::LOCK_CAPABILITY_SHARED | ‪self::LOCK_CAPABILITY_NOBLOCK;
 
        return $capabilities;
    }
 
    public function ‪destroy()
    {
        @unlink($this->filePath);
    }
}