CommandUtility.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\Utility;
 
use ‪TYPO3\CMS\Core\Core\Environment;
 
class ‪CommandUtility
{
    protected static bool ‪$initialized = false;
 
    protected static array ‪$applications = [];
 
    protected static ?array ‪$paths = null;
 
    public static function ‪exec(string $command, ?array &‪$output = null, int &$returnValue = 0): string
    {
        return ‪exec($command, ‪$output, $returnValue);
    }
 
    public static function ‪imageMagickCommand(string $command, string $parameters, string $path = ''): string
    {
        $gfxConf = ‪$GLOBALS['TYPO3_CONF_VARS']['GFX'];
        $isExt = ‪Environment::isWindows() ? '.exe' : '';
        if (!$path) {
            $path = (string)($gfxConf['processor_path'] ?? '');
        }
        $path = GeneralUtility::fixWindowsFilePath($path);
        // This is only used internally, has no effect outside
        if ($command === 'combine') {
            $command = 'composite';
        }
        // Compile the path & command
        if ($gfxConf['processor'] === 'GraphicsMagick') {
            $path = self::escapeShellArgument($path . 'gm' . $isExt) . ' ' . self::escapeShellArgument($command);
        } else {
            if (‪Environment::isWindows() && !@is_file($path . $command . $isExt)) {
                $path = self::escapeShellArgument($path . 'magick' . $isExt) . ' ' . self::escapeShellArgument($command);
            } else {
                $path = self::escapeShellArgument($path . $command . $isExt);
            }
        }
        // strip profile information for thumbnails and reduce their size
        if ($parameters && $command !== 'identify') {
            // Use legacy processor_stripColorProfileCommand setting if defined, otherwise
            // use the preferred configuration option processor_stripColorProfileParameters
            $stripColorProfileCommand = $gfxConf['processor_stripColorProfileCommand'] ??
                implode(' ', array_map(CommandUtility::escapeShellArgument(...), $gfxConf['processor_stripColorProfileParameters'] ?? []));
            // Determine whether the strip profile action has be disabled by TypoScript:
            if ($gfxConf['processor_stripColorProfileByDefault']
                && $stripColorProfileCommand !== ''
                && $parameters !== '-version'
                && !str_contains($parameters, $stripColorProfileCommand)
                && !str_contains($parameters, '###SkipStripProfile###')
            ) {
                $parameters = $stripColorProfileCommand . ' ' . $parameters;
            } else {
                $parameters = str_replace('###SkipStripProfile###', '', $parameters);
            }
        }
        // Add -auto-orient on convert so IM/GM respects the image orient
        if ($parameters && $command === 'convert') {
            $parameters = '-auto-orient ' . $parameters;
        }
        // set interlace parameter for convert command
        if ($command !== 'identify' && $gfxConf['processor_interlace']) {
            $parameters = '-interlace ' . CommandUtility::escapeShellArgument($gfxConf['processor_interlace']) . ' ' . $parameters;
        }
        $cmdLine = $path . ' ' . $parameters;
        // It is needed to change the parameters order when a mask image has been specified
        if ($command === 'composite') {
            $paramsArr = self::unQuoteFilenames($parameters);
            $paramsArrCount = count($paramsArr);
            if ($paramsArrCount > 5) {
                $tmp = $paramsArr[$paramsArrCount - 3];
                $paramsArr[$paramsArrCount - 3] = $paramsArr[$paramsArrCount - 4];
                $paramsArr[$paramsArrCount - 4] = $tmp;
            }
            $cmdLine = $path . ' ' . implode(' ', $paramsArr);
        }
        return $cmdLine;
    }
 
    public static function ‪checkCommand(string $cmd, string $handler = ''): bool|int
    {
        if (!self::init()) {
            return false;
        }
 
        if ($handler !== '' && !self::checkCommand($handler)) {
            return -1;
        }
        // Already checked and valid
        if (self::$applications[$cmd]['valid'] ?? false) {
            return true;
        }
        // Is set but was (above) not TRUE
        if (isset(self::$applications[$cmd]['valid'])) {
            return false;
        }
 
        foreach (self::$paths as $path => $validPath) {
            // Ignore invalid (FALSE) paths
            if ($validPath) {
                if (‪Environment::isWindows()) {
                    // Windows OS
                    // @todo Why is_executable() is not called here?
                    if (@is_file($path . $cmd)) {
                        self::$applications[$cmd]['app'] = $cmd;
                        self::$applications[$cmd]['path'] = $path;
                        self::$applications[$cmd]['valid'] = true;
                        return true;
                    }
                    if (@is_file($path . $cmd . '.exe')) {
                        self::$applications[$cmd]['app'] = $cmd . '.exe';
                        self::$applications[$cmd]['path'] = $path;
                        self::$applications[$cmd]['valid'] = true;
                        return true;
                    }
                } else {
                    // Unix-like OS
                    $filePath = realpath($path . $cmd);
                    if ($filePath && @is_executable($filePath)) {
                        self::$applications[$cmd]['app'] = $cmd;
                        self::$applications[$cmd]['path'] = $path;
                        self::$applications[$cmd]['valid'] = true;
                        return true;
                    }
                }
            }
        }
 
        // Try to get the executable with the command 'which'.
        // It does the same like already done, but maybe on other paths
        if (!‪Environment::isWindows()) {
            ‪$output = null;
            $returnValue = 0;
            $cmd = @‪self::exec('which ' . self::escapeShellArgument($cmd), ‪$output, $returnValue);
 
            if ($returnValue === 0) {
                self::$applications[$cmd]['app'] = $cmd;
                self::$applications[$cmd]['path'] = ‪PathUtility::dirname($cmd) . '/';
                self::$applications[$cmd]['valid'] = true;
                return true;
            }
        }
 
        return false;
    }
 
    public static function ‪getCommand(string $cmd, string $handler = '', string $handlerOpt = ''): string|bool|int
    {
        if (!self::init()) {
            return false;
        }
 
        // Handler
        if ($handler) {
            $handler = ‪self::getCommand($handler);
 
            if (!$handler) {
                return -1;
            }
            $handler .= ' ' . escapeshellcmd($handlerOpt) . ' ';
        }
 
        // Command
        if (!self::checkCommand($cmd)) {
            return false;
        }
        $cmd = self::$applications[$cmd]['path'] . self::$applications[$cmd]['app'] . ' ';
 
        return trim($handler . $cmd);
    }
 
    public static function ‪addPaths(string ‪$paths): void
    {
        self::initPaths(‪$paths);
    }
 
    public static function getPaths(bool $addInvalid = false): array
    {
        if (!self::init()) {
            return [];
        }
 
        return $addInvalid
            ? ‪self::$paths
            : array_filter(self::$paths);
    }
 
    protected static function init(): bool
    {
        if (‪$GLOBALS['TYPO3_CONF_VARS']['BE']['disable_exec_function']) {
            return false;
        }
        if (!self::$initialized) {
            self::initPaths();
            self::$applications = self::getConfiguredApps();
            self::$initialized = true;
        }
        return true;
    }
 
    protected static function initPaths(string ‪$paths = ''): void
    {
        $doCheck = false;
 
        // Init global paths array if not already done
        if (!is_array(self::$paths)) {
            self::$paths = self::getPathsInternal();
            $doCheck = true;
        }
        // Merge the submitted paths array to the global
        if (‪$paths) {
            ‪$paths = ‪GeneralUtility::trimExplode(',', ‪$paths, true);
            foreach (‪$paths as $path) {
                // Make absolute path of relative
                if (!str_starts_with($path, '/')) {
                    $path = ‪Environment::getPublicPath() . '/' . $path;
                }
                if (!isset(self::$paths[$path])) {
                    if (@is_dir($path)) {
                        self::$paths[$path] = $path;
                    } else {
                        self::$paths[$path] = false;
                    }
                }
            }
        }
        // Check if new paths are invalid
        if ($doCheck) {
            foreach (self::$paths as $path => $valid) {
                // Ignore invalid (FALSE) paths
                if ($valid && !@is_dir($path)) {
                    self::$paths[$path] = false;
                }
            }
        }
    }
 
    protected static function getConfiguredApps(): array
    {
        $cmdArr = [];
 
        if (‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['binSetup']) {
            $binSetup = str_replace(['\'.chr(10).\'', '\' . LF . \''], LF, ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['binSetup']);
            $pathSetup = preg_split('/[\n,]+/', $binSetup);
            foreach ($pathSetup as $val) {
                if (trim($val) === '') {
                    continue;
                }
                [$cmd, $cmdPath] = ‪GeneralUtility::trimExplode('=', $val, true, 2);
                $cmdArr[$cmd]['app'] = ‪PathUtility::basename($cmdPath);
                $cmdArr[$cmd]['path'] = ‪PathUtility::dirname($cmdPath) . '/';
                $cmdArr[$cmd]['valid'] = true;
            }
        }
 
        return $cmdArr;
    }
 
    protected static function getPathsInternal(): array
    {
        $pathsArr = [];
        $sysPathArr = [];
 
        // Image magick paths first
        if ($imPath = ‪$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_path']) {
            $imPath = self::fixPath($imPath);
            $pathsArr[$imPath] = $imPath;
        }
 
        // Add configured paths
        if (‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['binPath']) {
            $sysPath = ‪GeneralUtility::trimExplode(',', ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['binPath'], true);
            foreach ($sysPath as $val) {
                $val = self::fixPath($val);
                $sysPathArr[$val] = $val;
            }
        }
 
        // Add path from environment
        if (!empty(‪$GLOBALS['_SERVER']['PATH']) || !empty(‪$GLOBALS['_SERVER']['Path'])) {
            $sep = ‪Environment::isWindows() ? ';' : ':';
            $serverPath = ‪$GLOBALS['_SERVER']['PATH'] ?? ‪$GLOBALS['_SERVER']['Path'];
            $envPath = ‪GeneralUtility::trimExplode($sep, $serverPath, true);
            foreach ($envPath as $val) {
                $val = self::fixPath($val);
                $sysPathArr[$val] = $val;
            }
        }
 
        // Set common paths for Unix (only)
        if (!‪Environment::isWindows()) {
            $sysPathArr = array_merge($sysPathArr, [
                '/usr/bin/' => '/usr/bin/',
                '/usr/local/bin/' => '/usr/local/bin/',
            ]);
        }
 
        return array_merge($pathsArr, $sysPathArr);
    }
 
    protected static function fixPath(string $path): string
    {
        return str_replace('//', '/', $path . '/');
    }
 
    public static function escapeShellArguments(array $input): array
    {
        $isUTF8Filesystem = !empty(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['UTF8filesystem']);
        $currentLocale = false;
        if ($isUTF8Filesystem) {
            if (‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['systemLocale'] ?? false) {
                $currentLocale = setlocale(LC_CTYPE, '0');
                setlocale(LC_CTYPE, ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['systemLocale']);
            }
        }
 
        ‪$output = array_map('escapeshellarg', $input);
 
        if ($isUTF8Filesystem && $currentLocale !== false) {
            setlocale(LC_CTYPE, $currentLocale);
        }
 
        return ‪$output;
    }
 
    protected static function unQuoteFilenames(string $parameters): array
    {
        $paramsArr = explode(' ', trim($parameters));
        // Whenever a quote character (") is found, $quoteActive is set to the element number inside of $params.
        // A value of -1 means that there are not open quotes at the current position.
        $quoteActive = -1;
        foreach ($paramsArr as $k => $v) {
            if ($quoteActive > -1) {
                $paramsArr[$quoteActive] .= ' ' . $v;
                unset($paramsArr[$k]);
                if (substr($v, -1) === $paramsArr[$quoteActive][0]) {
                    $quoteActive = -1;
                }
            } elseif (!trim($v)) {
                // Remove empty elements
                unset($paramsArr[$k]);
            } elseif (preg_match('/^(["\'])/', $v) && substr($v, -1) !== $v[0]) {
                $quoteActive = $k;
            }
        }
        // Return re-indexed array
        return array_values($paramsArr);
    }
 
    public static function escapeShellArgument(string $input): string
    {
        return self::escapeShellArguments([$input])[0];
    }
}