ImageMagickFile.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * 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\Imaging;
 
use ‪TYPO3\CMS\Core\Imaging\Exception\UnsupportedFileException;
use ‪TYPO3\CMS\Core\Type\File\FileInfo;
use ‪TYPO3\CMS\Core\Utility\CommandUtility;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪ImageMagickFile
{
    protected ‪$filePath;
 
    protected ‪$frame;
 
    protected ‪$fileExists;
 
    protected ‪$fileExtension;
 
    protected ‪$mimeType;
 
    protected ‪$mimeExtensions = [];
 
    protected ‪$asArgument;
 
    protected ‪$allowedExtensions = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'tif', 'tiff', 'bmp', 'pcx', 'tga', 'ico'];
 
    protected ‪$deniedExtensions = ['epi', 'eps', 'eps2', 'eps3', 'epsf', 'epsi', 'ept', 'ept2', 'ept3', 'msl', 'ps', 'ps2', 'ps3'];
 
    protected ‪$mimeTypeExtensionMap = [
        'image/png' => 'png',
        'image/jpeg' => 'jpg',
        'image/gif' => 'gif',
        'image/heic' => 'heic',
        'image/heif' => 'heif',
        'image/webp' => 'webp',
        'image/svg' => 'svg',
        'image/svg+xml' => 'svg',
        'image/tiff' => 'tif',
        'application/pdf' => 'pdf',
    ];
 
    public static function ‪fromFilePath(string ‪$filePath, int ‪$frame = null): self
    {
        return GeneralUtility::makeInstance(
            static::class,
            ‪$filePath,
            ‪$frame
        );
    }
 
    public function ‪__construct(string ‪$filePath, int ‪$frame = null)
    {
        $this->frame = ‪$frame;
        $this->fileExists = file_exists(‪$filePath);
        $this->filePath = ‪$filePath;
        $this->fileExtension = pathinfo(‪$filePath, PATHINFO_EXTENSION);
 
        if ($this->fileExists) {
            $fileInfo = $this->‪getFileInfo($filePath);
            $this->mimeType = $fileInfo->getMimeType() ?: null;
            $this->mimeExtensions = $fileInfo->getMimeExtensions();
        }
 
        $this->asArgument = $this->‪escape(
            $this->‪resolvePrefix() . $this->filePath
            . ($this->frame !== null ? '[' . $this->frame . ']' : '')
        );
    }
 
    public function ‪__toString(): string
    {
        return ‪$this->asArgument;
    }
 
    protected function ‪resolvePrefix(): string
    {
        $prefixExtension = null;
        ‪$fileExtension = strtolower($this->fileExtension);
        if ($this->mimeType !== null && !empty($this->mimeTypeExtensionMap[$this->mimeType])) {
            $prefixExtension = $this->mimeTypeExtensionMap[‪$this->mimeType];
        } elseif (!empty($this->mimeExtensions) && str_starts_with((string)$this->mimeType, 'image/')) {
            $prefixExtension = $this->mimeExtensions[0];
        } elseif ($this->‪isInAllowedExtensions(‪$fileExtension)) {
            $prefixExtension = ‪$fileExtension;
        }
        if ($prefixExtension !== null && !in_array(strtolower($prefixExtension), $this->deniedExtensions, true)) {
            return $prefixExtension . ':';
        }
        throw new ‪UnsupportedFileException(
            sprintf(
                'Unsupported file %s (%s)',
                basename($this->filePath),
                $this->mimeType ?? 'unknown'
            ),
            1550060977
        );
    }
 
    protected function ‪escape(string $value): string
    {
        return CommandUtility::escapeShellArgument($value);
    }
 
    protected function ‪isInAllowedExtensions(string $extension): bool
    {
        return in_array($extension, $this->allowedExtensions, true);
    }
 
    protected function ‪getFileInfo(string ‪$filePath): FileInfo
    {
        return GeneralUtility::makeInstance(FileInfo::class, ‪$filePath);
    }
}