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-2006 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='')        {
                global $T3_VAR;

                if (!t3lib_exec::_init()) {
                        return false;
                }


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

                foreach($T3_VAR['t3lib_exec']['paths'] as $path => $validPath) {
                                // ignore invalid (false) paths
                        if ($validPath) {
                                if (TYPO3_OS=='WIN') {
                                        if (@is_file($path.$cmd)) {
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['app'] = $cmd;
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                                return true;
                                        }
                                        if (@is_file($path.$cmd.'.exe')) {
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['app'] = $cmd.'.exe';
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['valid'] = true;
                                                return true;
                                        }
                                } else { // UNIX
                                        if (@is_executable($path.$cmd)) {
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['app'] = $cmd;
                                                $T3_VAR['t3lib_exec']['apps'][$cmd]['path'] = $path;
                                                $T3_VAR['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 (TYPO3_OS!='WIN') {
                        $cmd = @exec ('which '.$cmd);

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

                return false;
        }


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

                if (!t3lib_exec::_init()) {
                        return false;
                }

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

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

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

                return trim($handler.$cmd);
        }


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



        function getPaths($addInvalid=false)    {
                global $T3_VAR;

                if (!t3lib_exec::_init()) {
                        return array();
                }

                $paths = $T3_VAR['t3lib_exec']['paths'];
                if(!$addInvalid) {

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


        function _init()        {
                global $T3_VAR, $TYPO3_CONF_VARS;

                if ($TYPO3_CONF_VARS['BE']['disable_exec_function']) {
                        return false;
                }
                if (!$T3_VAR['t3lib_exec']['init']) {
                        t3lib_exec::_initPaths();
                        $T3_VAR['t3lib_exec']['apps'] = t3lib_exec::_getConfiguredApps();;
                        $T3_VAR['t3lib_exec']['init'] = true;
                }
                return true;
        }


        function _initPaths($paths='')  {
                global $T3_VAR;

                $doCeck=false;

                        // init global paths array if not already done
                if (!is_array($T3_VAR['t3lib_exec']['paths'])) {
                        $T3_VAR['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)) {
                                foreach($paths as $path) {
                                                // make absolute path of relative
                                        if (!preg_match('#^/#',$path)) {
                                                $path = PATH_site.$path;
                                        }
                                        if (!isset($T3_VAR['t3lib_exec']['paths'][$path])) {
                                                if (@is_dir($path)) {
                                                        $T3_VAR['t3lib_exec']['paths'][$path] = $path;
                                                        $T3_VAR['t3lib_exec']['allPaths'].=','.$path;
                                                        // $doCeck=true; just done
                                                } else {
                                                        $T3_VAR['t3lib_exec']['paths'][$path] = false;
                                                }
                                        }
                                }
                        }
                }
                        // check if new paths are invalid
                if ($doCeck) {
                        $T3_VAR['t3lib_exec']['allPaths']='';
                        foreach($T3_VAR['t3lib_exec']['paths'] as $path => $valid) {
                                        // ignore invalid (false) paths
                                if ($valid AND !@is_dir($path)) {
                                        $T3_VAR['t3lib_exec']['paths'][$path] = false;
                                }
                                if ($path = $T3_VAR['t3lib_exec']['paths'][$path]) {
                                        $T3_VAR['t3lib_exec']['allPaths'].=','.$path;
                                }
                        }
                }
        }


        function _getConfiguredApps()   {
                global $TYPO3_CONF_VARS;

                $cmdArr = array();

                if ($TYPO3_CONF_VARS['SYS']['binSetup']) {
                        $pathSetup = implode("\n", t3lib_div::trimExplode(',',$TYPO3_CONF_VARS['SYS']['binSetup'],1));
                        $pathSetup = t3lib_div::trimExplode("\n",$pathSetup,1);
                        foreach($pathSetup as $val) {
                                list($cmd, $cmdPath) = t3lib_div::trimExplode('=',$val,1);

                                $cmdArr[$cmd]['app'] = basename($cmdPath);
                                $cmdArr[$cmd]['path'] = dirname($cmdPath).'/';
                                $cmdArr[$cmd]['valid'] = true;
                        }
                }

                return $cmdArr;
        }


        function _getPaths()    {
                global $T3_VAR, $TYPO3_CONF_VARS;

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

                        // 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);
                        foreach($sysPath as $val) {
                                $val = t3lib_exec::_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 = t3lib_div::trimExplode($sep,$GLOBALS['_SERVER']['PATH'],1);
                        foreach($envPath as $val) {
                                $val = t3lib_exec::_fixPath($val);
                                $sysPathArr[$val]=$val;
                        }
                }

                if (TYPO3_OS=='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/',
                        ));
                }


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

                return $pathsArr;
        }


        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']);
}
?>

---