[李景山php]每天laravel-20160909|Dispatcher-9

namespace Illuminate\Filesystem;

use Symfony\Component\Finder\Finder;
// use Finder
class ClassFinder
{
    /**
     * Find all the class and interface names in a given directory.
     *
     * @param  string  $directory
     * @return array
     */
    public function findClasses($directory)
    {// find all class and interface name maybe is too exaggerated
        $classes = [];// class listener

        foreach (Finder::create()->in($directory)->name('*.php') as $file) {
            $classes[] = $this->findClass($file->getRealPath());
        }// check all of this .php files name, if has .class.php ,

        return array_filter($classes);// if only on parameter ,then they will delete this value that it is null.
    }

    /**
     * Extract the class name from the file at the given path.
     *
     * @param  string  $path
     * @return string|null
     */
    public function findClass($path)
    {// extract  means get something from other thing.
        // like get class name by file path,
        $namespace = null;// set a null namespace

        $tokens = token_get_all(file_get_contents($path));// get all string like a php code

        foreach ($tokens as $key => $token) {
            if ($this->tokenIsNamespace($token)) {// if has namespace
                $namespace = $this->getNamespace($key + 2, $tokens);// get it
            } elseif ($this->tokenIsClassOrInterface($token)) {// if this class is a interface
                return ltrim($namespace.'\\'.$this->getClass($key + 2, $tokens), '\\');// use it self to make ltrim
            }
        }
    }

    /**
     * Find the namespace in the tokens starting at a given key.
     *
     * @param  int  $key
     * @param  array  $tokens
     * @return string|null
     */
    protected function getNamespace($key, array $tokens)
    {// Find the namespace in tokens starting at a given key.
        $namespace = null;// a namespace

        $tokenCount = count($tokens);// get this array count

        for ($i = $key; $i < $tokenCount; $i++) {// if has tokens
            if ($this->isPartOfNamespace($tokens[$i])) {// if this is a  namespace ,even it is a array
                $namespace .= $tokens[$i][1];//
            } elseif ($tokens[$i] == ';') {// if
                return $namespace;// null return
            }
        }
    }

    /**
     * Find the class in the tokens starting at a given key.
     *
     * @param  int  $key
     * @param  array  $tokens
     * @return string|null
     */
    protected function getClass($key, array $tokens)
    {
        $class = null;

        $tokenCount = count($tokens);

        for ($i = $key; $i < $tokenCount; $i++) {
            if ($this->isPartOfClass($tokens[$i])) {
                $class .= $tokens[$i][1];
            } elseif ($this->isWhitespace($tokens[$i])) {
                return $class;
            }
        }
    }// same too
    /**
     * Determine if the given token is a namespace keyword.
     *
     * @param  array|string  $token
     * @return bool
     */
    protected function tokenIsNamespace($token)
    {
        return is_array($token) && $token[0] == T_NAMESPACE;// is a array then check this token[0] is a T_NAMESPACE
    }// determine given token is a namespace keyword

    /**
     * Determine if the given token is a class or interface keyword.
     *
     * @param  array|string  $token
     * @return bool
     */
    protected function tokenIsClassOrInterface($token)
    {
        return is_array($token) && ($token[0] == T_CLASS || $token[0] == T_INTERFACE);
    }//Determine if the given token is a class or interface keyword.
    // first this token is array, and the first is a T_CLASS

    /**
     * Determine if the given token is part of the namespace.
     *
     * @param  array|string  $token
     * @return bool
     */
    protected function isPartOfNamespace($token)
    {
        return is_array($token) && ($token[0] == T_STRING || $token[0] == T_NS_SEPARATOR);
    }// check given token is part of the namesapce.

    /**
     * Determine if the given token is part of the class.
     *
     * @param  array|string  $token
     * @return bool
     */
    protected function isPartOfClass($token)
    {
        return is_array($token) && $token[0] == T_STRING;
    }// check class

    /**
     * Determine if the given token is whitespace.
     *
     * @param  array|string  $token
     * @return bool
     */
    protected function isWhitespace($token)
    {
        return is_array($token) && $token[0] == T_WHITESPACE;
    }// check is Whitespace
}