[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  /*
   4   * This file is part of the Symfony package.
   5   *
   6   * (c) Fabien Potencier <fabien@symfony.com>
   7   *
   8   * For the full copyright and license information, please view the LICENSE
   9   * file that was distributed with this source code.
  10   */
  11  
  12  namespace Symfony\Component\Process;
  13  
  14  /**
  15   * Generic executable finder.
  16   *
  17   * @author Fabien Potencier <fabien@symfony.com>
  18   * @author Johannes M. Schmitt <schmittjoh@gmail.com>
  19   */
  20  class ExecutableFinder
  21  {
  22      private $suffixes = ['.exe', '.bat', '.cmd', '.com'];
  23  
  24      /**
  25       * Replaces default suffixes of executable.
  26       */
  27      public function setSuffixes(array $suffixes)
  28      {
  29          $this->suffixes = $suffixes;
  30      }
  31  
  32      /**
  33       * Adds new possible suffix to check for executable.
  34       *
  35       * @param string $suffix
  36       */
  37      public function addSuffix($suffix)
  38      {
  39          $this->suffixes[] = $suffix;
  40      }
  41  
  42      /**
  43       * Finds an executable by name.
  44       *
  45       * @param string      $name      The executable name (without the extension)
  46       * @param string|null $default   The default to return if no executable is found
  47       * @param array       $extraDirs Additional dirs to check into
  48       *
  49       * @return string|null The executable path or default value
  50       */
  51      public function find($name, $default = null, array $extraDirs = [])
  52      {
  53          if (ini_get('open_basedir')) {
  54              $searchPath = array_merge(explode(\PATH_SEPARATOR, ini_get('open_basedir')), $extraDirs);
  55              $dirs = [];
  56              foreach ($searchPath as $path) {
  57                  // Silencing against https://bugs.php.net/69240
  58                  if (@is_dir($path)) {
  59                      $dirs[] = $path;
  60                  } else {
  61                      if (basename($path) == $name && @is_executable($path)) {
  62                          return $path;
  63                      }
  64                  }
  65              }
  66          } else {
  67              $dirs = array_merge(
  68                  explode(\PATH_SEPARATOR, getenv('PATH') ?: getenv('Path')),
  69                  $extraDirs
  70              );
  71          }
  72  
  73          $suffixes = [''];
  74          if ('\\' === \DIRECTORY_SEPARATOR) {
  75              $pathExt = getenv('PATHEXT');
  76              $suffixes = array_merge($pathExt ? explode(\PATH_SEPARATOR, $pathExt) : $this->suffixes, $suffixes);
  77          }
  78          foreach ($suffixes as $suffix) {
  79              foreach ($dirs as $dir) {
  80                  if (@is_file($file = $dir.\DIRECTORY_SEPARATOR.$name.$suffix) && ('\\' === \DIRECTORY_SEPARATOR || @is_executable($file))) {
  81                      return $file;
  82                  }
  83              }
  84          }
  85  
  86          return $default;
  87      }
  88  }