Documentation TYPO3 par Ameos

Disponible dans d'autres versions de TYPO3 -> 3.7.0  3.8.1  4.0.0  4.0.1  4.1.0   <- Available in other TYPO3 versions

class.t3lib_exec.php

<?php
/***************************************************************
*  Copyright notice
*
*  (c) 2002-2004 René Fritz (r.fritz@colorcube.de)
*  All rights reserved
*
*  This script is part of the Typo3 project. The Typo3 project is
*  free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  The GNU General Public License can be found at
*  http://www.gnu.org/copyleft/gpl.html.
*
*  This script is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
class t3lib_exec {

        function checkCommand($cmd, $handler='')        {

                t3lib_exec::_init();
                $osType = t3lib_exec::_getOS();


#debug($GLOBALS['t3lib_exec'], 't3lib_exec', __LINE__, __FILE__);

                if ($handler && !t3lib_exec::checkCommand($handler)) {
                        return -1;
                }
                        // already checked and valid
                if ($GLOBALS['t3lib_exec']['apps'][$cmd]['valid']) {
                        return true;
                }
                        // is set but was (above) not true
                if (isset($GLOBALS['t3lib_exec']['apps'][$cmd]['valid'])) {
                        return false;
                }

                reset($GLOBALS['t3lib_exec']['paths']);
                foreach($GLOBALS['t3lib_exec']['paths'] as $path => $validPath) {
                                // ignore invalid (false) paths
                        if ($validPath) {
                                if ($osType=='WIN') {
                                        if (@is_file($path.$cmd)) {
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['app'] = $cmd;
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                                return true;
                                        }
                                        if (@is_file($path.$cmd.'.exe')) {
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['app'] = $cmd.'.exe';
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                                return true;
                                        }
                                } else { // UNIX
                                        if (@is_executable($path.$cmd)) {
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['app'] = $cmd;
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $GLOBALS['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                                return true;
                                        }
                                }
                        }
                }

                        // try to get the executable with the command 'which'. It do the same like already done, but maybe on other paths??
                if ($osType=='UNIX') {
                        $cmd = @exec ('which '.$val['cmd']);

                        if (@is_executable($cmd)) {
                                $GLOBALS['t3lib_exec']['apps'][$cmd]['app'] = $cmd;
                                $GLOBALS['t3lib_exec']['apps'][$cmd]['path'] = dirname($cmd).'/';
                                $GLOBALS['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                return true;
                        }
                }

                return false;
        }

        function getCommand($cmd, $handler='', $handlerOpt='')  {

                t3lib_exec::_init();

                        // handler
                if ($handler) {
                        $handler = t3lib_exec::getCommand($handler);

                        if (!$handler) {
                                return -1;
                        }
                        $handler .= ' '.$handlerOpt.' ';
                }

                        // command
                if (!t3lib_exec::checkCommand($cmd)) {
                        return false;
                }
                $cmd = $GLOBALS['t3lib_exec']['apps'][$cmd]['path'].$GLOBALS['t3lib_exec']['apps'][$cmd]['app'].' ';

                return $handler.$cmd;
        }

        function addPaths($paths)       {
                t3lib_exec::_initPaths($paths);
        }

        function _getPaths()    {
                global $TYPO3_CONF_VARS;

                $pathsArr = array();
                $sysPathArr = array();
                $osType = t3lib_exec::_getOS();

                        // image magick paths first
                        // im_path_lzw take precedence over im_path
                if ($imPath = ($TYPO3_CONF_VARS['GFX']['im_path_lzw'] ? $TYPO3_CONF_VARS['GFX']['im_path_lzw'] : $TYPO3_CONF_VARS['GFX']['im_path'])) {
                        $imPath = t3lib_exec::_fixPath($imPath);
                        $pathsArr[$imPath] = $imPath;
                }

                        // add configured paths
                if ($TYPO3_CONF_VARS['SYS']['binPath']) {
                        $sysPath = t3lib_div::trimExplode(',',$TYPO3_CONF_VARS['SYS']['binPath'],1);
                        reset($sysPath);
                        while(list(,$val)=each($sysPath)) {
                                $val = t3lib_exec::_fixPath($val);
                                $sysPathArr[$val]=$val;
                        }
                }




# ???? t3lib_div::getIndpEnv('REQUEST_URI');


                        // add path from environment
#TODO: how does this work for WIN
                if ($GLOBALS['_SERVER']['PATH']) {
                        $sep = ($osType=='WIN') ? ';' : ':';
                        $envPath = t3lib_div::trimExplode($sep,$GLOBALS['_SERVER']['PATH'],1);
                        reset($envPath);
                        while(list(,$val)=each($envPath)) {
                                $val = t3lib_exec::_fixPath($val);
                                $sysPathArr[$val]=$val;
                        }
                }

                if ($osType=='WIN') {
#TODO: add the most common paths for WIN
                        $sysPathArr = array_merge($sysPathArr, array (
                                '/usr/bin/' => '/usr/bin/',
                                '/perl/bin/' => '/perl/bin/',
                        ));
                } else { // UNIX
                        $sysPathArr = array_merge($sysPathArr, array (
                                '/usr/bin/' => '/usr/bin/',
                                '/usr/local/bin/' => '/usr/local/bin/',
                        ));
                }

#debug($pathsArr, '$pathsArr', __LINE__, __FILE__);
#debug($GLOBALS['_SERVER']['PATH'], 'PATH', __LINE__, __FILE__);

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

        function _init()        {
                if (!$GLOBALS['t3lib_exec']['init']) {

                        t3lib_exec::_initPaths();
                        $GLOBALS['t3lib_exec']['apps'] = array();
                        $GLOBALS['t3lib_exec']['init'] = true;
                }
        }

        function _initPaths($paths='')  {
                $doCeck=false;

                        // init global paths array if not already done
                if (!is_array($GLOBALS['t3lib_exec']['paths'])) {
                        $GLOBALS['t3lib_exec']['paths'] = t3lib_exec::_getPaths();
                        $doCeck=true;
                }
                        // merge the submitted paths array to the global
                if ($paths) {
                        $paths = t3lib_div::trimExplode(',',$paths,1);
                        if (is_array($paths)) {
                                reset($paths);
                                while(list(,$path)=each($paths)) {
                                                // make absolute path of relative
                                        if (!preg_match('#^/#',$path)) {
                                                $path = PATH_site.$path;
                                        }
                                        if (!isset($GLOBALS['t3lib_exec']['paths'][$path])) {
                                                if (@is_dir($path)) {
                                                        $GLOBALS['t3lib_exec']['paths'][$path] = $path;
                                                        $GLOBALS['t3lib_exec']['allPaths'].=','.$path;
                                                        // $doCeck=true; just done
                                                } else {
                                                        $GLOBALS['t3lib_exec']['paths'][$path] = false;
                                                }
                                        }
                                }
                        }
                }
                        // check if new paths are invalid
                if ($doCeck) {
                        $GLOBALS['t3lib_exec']['allPaths']='';
                        reset($GLOBALS['t3lib_exec']['paths']);
                        while(list($path,$valid)=each($GLOBALS['t3lib_exec']['paths'])) {
                                        // ignore invalid (false) paths
#TODO: what's the idea not to remove invalid paths?
                                if ($valid) {
                                        if (!@is_dir($path)) {
                                                $GLOBALS['t3lib_exec']['paths'][$path] = false;
                                        }
                                }
                                if ($path = $GLOBALS['t3lib_exec']['paths'][$path]) {
                                        $GLOBALS['t3lib_exec']['allPaths'].=','.$path;
                                }
                        }
                }
        }

        function _getOS()       {
                return stristr(PHP_OS,'win')&&!stristr(PHP_OS,'darwin')?'WIN':'UNIX';
        }

        function _fixPath($path)        {
                return str_replace ('//',"/",$path.'/');
        }
}

if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_exec.php'])      {
        include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_exec.php']);
}
?>

---