FileHandlingUtility.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\Extensionmanager\Utility;
 
use Psr\Log\LoggerAwareInterface;
use Psr\Log\LoggerAwareTrait;
use ‪TYPO3\CMS\Core\Core\Environment;
use ‪TYPO3\CMS\Core\Exception\Archive\ExtractException;
use ‪TYPO3\CMS\Core\Localization\LanguageService;
use ‪TYPO3\CMS\Core\Localization\LanguageServiceFactory;
use ‪TYPO3\CMS\Core\Service\Archive\ZipService;
use ‪TYPO3\CMS\Core\SingletonInterface;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\PathUtility;
use ‪TYPO3\CMS\Extensionmanager\Domain\Model\Extension;
use ‪TYPO3\CMS\Extensionmanager\Exception\ExtensionManagerException;
 
class ‪FileHandlingUtility implements ‪SingletonInterface, LoggerAwareInterface
{
    use LoggerAwareTrait;
 
    protected ‪$emConfUtility;
 
    protected ‪$installUtility;
 
    protected ‪LanguageServiceFactory ‪$languageServiceFactory;
    protected ?‪LanguageService ‪$languageService = null;
 
    public function ‪injectEmConfUtility(EmConfUtility ‪$emConfUtility)
    {
        $this->emConfUtility = ‪$emConfUtility;
    }
 
    public function ‪injectInstallUtility(‪InstallUtility ‪$installUtility)
    {
        $this->installUtility = ‪$installUtility;
    }
 
    public function ‪injectLanguageServiceFactory(‪LanguageServiceFactory ‪$languageServiceFactory)
    {
        $this->languageServiceFactory = ‪$languageServiceFactory;
    }
 
    public function ‪initializeObject()
    {
        $this->languageService = $this->languageServiceFactory->createFromUserPreferences(‪$GLOBALS['BE_USER'] ?? null);
        $this->languageService->includeLLFile('EXT:extensionmanager/Resources/Private/Language/locallang.xlf');
    }
 
    public function ‪unpackExtensionFromExtensionDataArray(string $extensionKey, array $extensionData, $pathType = 'Local')
    {
        $files = $extensionData['FILES'] ?? [];
        $emConfData = $extensionData['EM_CONF'] ?? [];
        $extensionDir = $this->‪makeAndClearExtensionDir($extensionKey, $pathType);
        $directories = $this->‪extractDirectoriesFromExtensionData($files);
        $files = array_diff_key($files, array_flip($directories));
        $this->‪createDirectoriesForExtensionFiles($directories, $extensionDir);
        $this->‪writeExtensionFiles($files, $extensionDir);
        $this->‪writeEmConfToFile($extensionKey, $emConfData, $extensionDir);
        $this->‪reloadPackageInformation($extensionKey);
    }
 
    protected function ‪extractDirectoriesFromExtensionData(array $files)
    {
        $directories = [];
        foreach ($files as $filePath => $file) {
            preg_match('/(.*)\\//', $filePath, $matches);
            if (!empty($matches[0])) {
                $directories[] = $matches[0];
            }
        }
        return array_unique($directories);
    }
 
    protected function ‪createDirectoriesForExtensionFiles(array $directories, string $rootPath)
    {
        foreach ($directories as $directory) {
            $this->‪createNestedDirectory($rootPath . $directory);
        }
    }
 
    protected function ‪createNestedDirectory($directory)
    {
        try {
            ‪GeneralUtility::mkdir_deep($directory);
        } catch (\RuntimeException $exception) {
            throw new ExtensionManagerException(
                sprintf($this->languageService->getLL('fileHandling.couldNotCreateDirectory'), $this->getRelativePath($directory)),
                1337280416
            );
        }
    }
 
    protected function ‪writeExtensionFiles(array $files, $rootPath)
    {
        foreach ($files as $file) {
            ‪GeneralUtility::writeFile($rootPath . $file['name'], $file['content']);
        }
    }
 
    protected function ‪makeAndClearExtensionDir($extensionKey, $pathType = 'Local')
    {
        $extDirPath = $this->‪getExtensionDir($extensionKey, $pathType);
        if (is_dir($extDirPath)) {
            $this->‪removeDirectory($extDirPath);
        }
        $this->‪addDirectory($extDirPath);
        return $extDirPath;
    }
 
    public function ‪getExtensionDir($extensionKey, $pathType = 'Local')
    {
        $paths = ‪Extension::returnInstallPaths();
        $path = $paths[$pathType] ?? '';
        if (!$path || !is_dir($path) || !$extensionKey) {
            throw new ExtensionManagerException(
                sprintf($this->languageService->getLL('fileHandling.installPathWasNoDirectory'), $this->getRelativePath($path)),
                1337280417
            );
        }
 
        return $path . $extensionKey . '/';
    }
 
    protected function ‪addDirectory($extDirPath)
    {
        ‪GeneralUtility::mkdir($extDirPath);
        if (!is_dir($extDirPath)) {
            throw new ExtensionManagerException(
                sprintf($this->languageService->getLL('fileHandling.couldNotCreateDirectory'), $this->getRelativePath($extDirPath)),
                1337280418
            );
        }
    }
 
    public function ‪removeDirectory($extDirPath)
    {
        $extDirPath = GeneralUtility::fixWindowsFilePath($extDirPath);
        $extensionPathWithoutTrailingSlash = rtrim($extDirPath, '/');
        if (is_link($extensionPathWithoutTrailingSlash) && !‪Environment::isWindows()) {
            $result = unlink($extensionPathWithoutTrailingSlash);
        } else {
            $result = ‪GeneralUtility::rmdir($extDirPath, true);
        }
        if ($result === false) {
            throw new ExtensionManagerException(
                sprintf($this->languageService->getLL('fileHandling.couldNotRemoveDirectory'), $this->getRelativePath($extDirPath)),
                1337280415
            );
        }
    }
 
    protected function ‪writeEmConfToFile(string $extensionKey, array $emConfData, string $rootPath)
    {
        $emConfContent = $this->emConfUtility->constructEmConf($extensionKey, $emConfData);
        ‪GeneralUtility::writeFile($rootPath . 'ext_emconf.php', $emConfContent);
    }
 
    protected function ‪getRelativePath(string $absolutePath): string
    {
        return ‪PathUtility::stripPathSitePrefix($absolutePath);
    }
 
    public function ‪unzipExtensionFromFile($file, $fileName, $pathType = 'Local')
    {
        $extensionDir = $this->‪makeAndClearExtensionDir($fileName, $pathType);
 
        try {
            $zipService = GeneralUtility::makeInstance(ZipService::class);
            if ($zipService->verify($file)) {
                $zipService->extract($file, $extensionDir);
            }
        } catch (ExtractException $e) {
            $this->logger->error('Extracting the extension archive failed', ['exception' => $e]);
            throw new ExtensionManagerException('Extracting the extension archive failed: ' . $e->getMessage(), 1565777179, $e);
        }
 
        ‪GeneralUtility::fixPermissions($extensionDir, true);
    }
 
    protected function ‪reloadPackageInformation($extensionKey)
    {
        $this->installUtility->reloadPackageInformation($extensionKey);
    }
}