CommandUtility.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Utility;

class CommandUtility {

    protected static $initialized = FALSE;

    protected static $applications = array();

    protected static $paths = NULL;

    static public function exec($command, &$output = NULL, &$returnValue = 0) {
        $lastLine = exec($command, $output, $returnValue);
        return $lastLine;
    }

    static public function imageMagickCommand($command, $parameters, $path = '') {
        $gfxConf = $GLOBALS['TYPO3_CONF_VARS']['GFX'];
        $isExt = TYPO3_OS == 'WIN' ? '.exe' : '';
        $switchCompositeParameters = FALSE;
        if (!$path) {
            $path = $gfxConf['im_path'];
        }
        $path = \TYPO3\CMS\Core\Utility\GeneralUtility::fixWindowsFilePath($path);
        $im_version = strtolower($gfxConf['im_version_5']);
        // This is only used internally, has no effect outside
        if ($command === 'combine') {
            $command = 'composite';
        }
        // Compile the path & command
        if ($im_version === 'gm') {
            $switchCompositeParameters = TRUE;
            $path = escapeshellarg(($path . 'gm' . $isExt)) . ' ' . $command;
        } else {
            if ($im_version === 'im6') {
                $switchCompositeParameters = TRUE;
            }
            $path = escapeshellarg($path . ($command == 'composite' ? 'composite' : $command) . $isExt);
        }
        // strip profile information for thumbnails and reduce their size
        if ($parameters && $command != 'identify' && $gfxConf['im_useStripProfileByDefault'] && $gfxConf['im_stripProfileCommand'] != '') {
            if (strpos($parameters, $gfxConf['im_stripProfileCommand']) === FALSE) {
                // Determine whether the strip profile action has be disabled by TypoScript:
                if ($parameters !== '-version' && strpos($parameters, '###SkipStripProfile###') === FALSE) {
                    $parameters = $gfxConf['im_stripProfileCommand'] . ' ' . $parameters;
                } else {
                    $parameters = str_replace('###SkipStripProfile###', '', $parameters);
                }
            }
        }
        $cmdLine = $path . ' ' . $parameters;
        // Because of some weird incompatibilities between ImageMagick 4 and 6 (plus GraphicsMagick),
        // it is needed to change the parameters order under some preconditions
        if ($command == 'composite' && $switchCompositeParameters) {
            $paramsArr = \TYPO3\CMS\Core\Utility\GeneralUtility::unQuoteFilenames($parameters);
            // The mask image has been specified => swap the parameters
            if (count($paramsArr) > 5) {
                $tmp = $paramsArr[count($paramsArr) - 3];
                $paramsArr[count($paramsArr) - 3] = $paramsArr[count($paramsArr) - 4];
                $paramsArr[count($paramsArr) - 4] = $tmp;
            }
            $cmdLine = $path . ' ' . implode(' ', $paramsArr);
        }
        return $cmdLine;
    }

    public static function checkCommand($cmd, $handler = '') {
        if (!self::init()) {
            return FALSE;
        }

        if ($handler && !self::checkCommand($handler)) {
            return -1;
        }
            // Already checked and valid
        if (self::$applications[$cmd]['valid']) {
            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 (TYPO3_OS == 'WIN') {
                        // 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 (TYPO3_OS != 'WIN') {
            $cmd = @self::exec('which ' . $cmd);
            if (@is_executable($cmd)) {
                self::$applications[$cmd]['app'] = $cmd;
                self::$applications[$cmd]['path'] = dirname($cmd) . '/';
                self::$applications[$cmd]['valid'] = TRUE;
                return TRUE;
            }
        }

        return FALSE;
    }

    public static function getCommand($cmd, $handler = '', $handlerOpt = '') {
        if (!self::init()) {
            return FALSE;
        }

            // Handler
        if ($handler) {
            $handler = self::getCommand($handler);

            if (!$handler) {
                return -1;
            }
            $handler .= ' ' . $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($paths) {
        self::initPaths($paths);
    }

    public static function getPaths($addInvalid = FALSE) {
        if (!self::init()) {
            return array();
        }

        $paths = self::$paths;

        if (!$addInvalid) {
            foreach ($paths as $path => $validPath) {
                if (!$validPath) {
                    unset($paths[$path]);
                }
            }
        }
        return $paths;
    }

    protected static function init() {
        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($paths = '') {
        $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);
            if (is_array($paths)) {
                foreach ($paths as $path) {
                        // Make absolute path of relative
                    if (!preg_match('#^/#', $path)) {
                        $path = PATH_site . $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 AND !@is_dir($path)) {
                    self::$paths[$path] = FALSE;
                }
            }
        }
    }

    protected static function getConfiguredApps() {
        $cmdArr = array();

        if ($GLOBALS['TYPO3_CONF_VARS']['SYS']['binSetup']) {
            $binSetup = str_replace(array('\'.chr(10).\'', '\' . LF . \''), LF, $GLOBALS['TYPO3_CONF_VARS']['SYS']['binSetup']);
            $pathSetup = preg_split('/[\n,]+/', $binSetup);
            foreach ($pathSetup as $val) {
                if (trim($val) === '') {
                    continue;
                }
                list($cmd, $cmdPath) = GeneralUtility::trimExplode('=', $val, TRUE, 2);
                $cmdArr[$cmd]['app'] = basename($cmdPath);
                $cmdArr[$cmd]['path'] = dirname($cmdPath) . '/';
                $cmdArr[$cmd]['valid'] = TRUE;
            }
        }

        return $cmdArr;
    }

    protected static function getPathsInternal() {

        $pathsArr = array();
        $sysPathArr = array();

            // Image magick paths first
            // im_path_lzw take precedence over im_path
        if (($imPath = ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_path_lzw'] ?: $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_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
            // TODO: how does this work for WIN
        if ($GLOBALS['_SERVER']['PATH']) {
            $sep = (TYPO3_OS == 'WIN' ? ';' : ':');
            $envPath = GeneralUtility::trimExplode($sep, $GLOBALS['_SERVER']['PATH'], TRUE);
            foreach ($envPath as $val) {
                $val = self::fixPath($val);
                $sysPathArr[$val] = $val;
            }
        }

            // Set common paths for Unix (only)
        if (TYPO3_OS !== 'WIN') {
            $sysPathArr = array_merge($sysPathArr, array(
                '/usr/bin/' => '/usr/bin/',
                '/usr/local/bin/' => '/usr/local/bin/',
            ));
        }

        $pathsArr = array_merge($pathsArr, $sysPathArr);

        return $pathsArr;
    }


    protected static function fixPath($path) {
        return str_replace('//', '/', $path . '/');
    }

}