FileList.php

<?php


/**
 * Represents a list of files on the file system that are to be checked during the run.
 *
 * File objects are created as needed rather than all at once.
 *
 * @author    Greg Sherwood <gsherwood@squiz.net>
 * @copyright 2006-2015 Squiz Pty Ltd (ABN 77 084 670 600)
 * @license   https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
 */
namespace PHP_CodeSniffer\Files;

use Countable;
use FilesystemIterator;
use Iterator;
use PHP_CodeSniffer\Autoload;
use PHP_CodeSniffer\Config;
use PHP_CodeSniffer\Exceptions\DeepExitException;
use PHP_CodeSniffer\Ruleset;
use PHP_CodeSniffer\Util\Common;
use RecursiveArrayIterator;
use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
use ReturnTypeWillChange;
class FileList implements Iterator, Countable {
    
    /**
     * A list of file paths that are included in the list.
     *
     * @var array
     */
    private $files = [];
    
    /**
     * The number of files in the list.
     *
     * @var integer
     */
    private $numFiles = 0;
    
    /**
     * The config data for the run.
     *
     * @var \PHP_CodeSniffer\Config
     */
    public $config = null;
    
    /**
     * The ruleset used for the run.
     *
     * @var \PHP_CodeSniffer\Ruleset
     */
    public $ruleset = null;
    
    /**
     * An array of patterns to use for skipping files.
     *
     * @var array
     */
    protected $ignorePatterns = [];
    
    /**
     * Constructs a file list and loads in an array of file paths to process.
     *
     * @param \PHP_CodeSniffer\Config  $config  The config data for the run.
     * @param \PHP_CodeSniffer\Ruleset $ruleset The ruleset used for the run.
     *
     * @return void
     */
    public function __construct(Config $config, Ruleset $ruleset) {
        $this->ruleset = $ruleset;
        $this->config = $config;
        $paths = $config->files;
        foreach ($paths as $path) {
            $isPharFile = Common::isPharFile($path);
            if (is_dir($path) === true || $isPharFile === true) {
                if ($isPharFile === true) {
                    $path = 'phar://' . $path;
                }
                $filterClass = $this->getFilterClass();
                $di = new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::SKIP_DOTS | FilesystemIterator::FOLLOW_SYMLINKS);
                $filter = new $filterClass($di, $path, $config, $ruleset);
                $iterator = new RecursiveIteratorIterator($filter);
                foreach ($iterator as $file) {
                    $this->files[$file->getPathname()] = null;
                    $this->numFiles++;
                }
            }
            else {
                $this->addFile($path);
            }
            
            //end if
        }
        
        //end foreach
        reset($this->files);
    }
    
    //end __construct()
    
    /**
     * Add a file to the list.
     *
     * If a file object has already been created, it can be passed here.
     * If it is left NULL, it will be created when accessed.
     *
     * @param string                      $path The path to the file being added.
     * @param \PHP_CodeSniffer\Files\File $file The file being added.
     *
     * @return void
     */
    public function addFile($path, $file = null) {
        // No filtering is done for STDIN when the filename
        // has not been specified.
        if ($path === 'STDIN') {
            $this->files[$path] = $file;
            $this->numFiles++;
            return;
        }
        $filterClass = $this->getFilterClass();
        $di = new RecursiveArrayIterator([
            $path,
        ]);
        $filter = new $filterClass($di, $path, $this->config, $this->ruleset);
        $iterator = new RecursiveIteratorIterator($filter);
        foreach ($iterator as $path) {
            $this->files[$path] = $file;
            $this->numFiles++;
        }
    }
    
    //end addFile()
    
    /**
     * Get the class name of the filter being used for the run.
     *
     * @return string
     * @throws \PHP_CodeSniffer\Exceptions\DeepExitException If the specified filter could not be found.
     */
    private function getFilterClass() {
        $filterType = $this->config->filter;
        if ($filterType === null) {
            $filterClass = '\\PHP_CodeSniffer\\Filters\\Filter';
        }
        else {
            if (strpos($filterType, '.') !== false) {
                // This is a path to a custom filter class.
                $filename = realpath($filterType);
                if ($filename === false) {
                    $error = "ERROR: Custom filter \"{$filterType}\" not found" . PHP_EOL;
                    throw new DeepExitException($error, 3);
                }
                $filterClass = Autoload::loadFile($filename);
            }
            else {
                $filterClass = '\\PHP_CodeSniffer\\Filters\\' . $filterType;
            }
        }
        return $filterClass;
    }
    
    //end getFilterClass()
    
    /**
     * Rewind the iterator to the first file.
     *
     * @return void
     */
    public function rewind() {
        reset($this->files);
    }
    
    //end rewind()
    
    /**
     * Get the file that is currently being processed.
     *
     * @return \PHP_CodeSniffer\Files\File
     */
    public function current() {
        $path = key($this->files);
        if (isset($this->files[$path]) === false) {
            $this->files[$path] = new LocalFile($path, $this->ruleset, $this->config);
        }
        return $this->files[$path];
    }
    
    //end current()
    
    /**
     * Return the file path of the current file being processed.
     *
     * @return string|null Path name or `null` when the end of the iterator has been reached.
     */
    public function key() {
        return key($this->files);
    }
    
    //end key()
    
    /**
     * Move forward to the next file.
     *
     * @return void
     */
    public function next() {
        next($this->files);
    }
    
    //end next()
    
    /**
     * Checks if current position is valid.
     *
     * @return boolean
     */
    public function valid() {
        if (current($this->files) === false) {
            return false;
        }
        return true;
    }
    
    //end valid()
    
    /**
     * Return the number of files in the list.
     *
     * @return integer
     */
    public function count() {
        return $this->numFiles;
    }
    
    //end count()

}

//end class