<?php

/*

 * This file is part of the Symfony package.

 *

 * (c) Fabien Potencier <fabien@symfony.com>

 *

 * For the full copyright and license information, please view the LICENSE

 * file that was distributed with this source code.

 */

namespace Symfony\Component\Routing\Loader;

use Symfony\Component\Routing\RouteCollection;

use Symfony\Component\Config\Resource\FileResource;

use Symfony\Component\Config\Loader\FileLoader;

use Symfony\Component\Config\FileLocator;

/**

 * AnnotationFileLoader loads routing information from annotations set

 * on a PHP class and its methods.

 *

 * @author Fabien Potencier <fabien@symfony.com>

 */

class AnnotationFileLoader extends FileLoader

{

    protected $loader;

    /**

     * Constructor.

     *

     * @param FileLocator           $locator A FileLocator instance

     * @param AnnotationClassLoader $loader  An AnnotationClassLoader instance

     * @param string|array          $paths   A path or an array of paths where to look for resources

     */

    public function __construct(FileLocator $locator, AnnotationClassLoader $loader, $paths = array())

    {

        if (!function_exists('token_get_all')) {

            throw new \RuntimeException('The Tokenizer extension is required for the routing annotation loaders.');

        }

        parent::__construct($locator, $paths);

        $this->loader = $loader;

    }

    /**

     * Loads from annotations from a file.

     *

     * @param string $file A PHP file path

     * @param string $type The resource type

     *

     * @return RouteCollection A RouteCollection instance

     *

     * @throws \InvalidArgumentException When the file does not exist or its routes cannot be parsed

     */

    public function load($file, $type = null)

    {

        $path = $this->locator->locate($file);

        $collection = new RouteCollection();

        if ($class = $this->findClass($path)) {

            $collection->addResource(new FileResource($path));

            $collection->addCollection($this->loader->load($class, $type));

        }

        return $collection;

    }

    /**

     * Returns true if this class supports the given resource.

     *

     * @param mixed  $resource A resource

     * @param string $type     The resource type

     *

     * @return Boolean True if this class supports the given resource, false otherwise

     */

    public function supports($resource, $type = null)

    {

        return is_string($resource) && 'php' === pathinfo($resource, PATHINFO_EXTENSION) && (!$type || 'annotation' === $type);

    }

    /**

     * Returns the full class name for the first class in the file.

     *

     * @param string $file A PHP file path

     *

     * @return string|false Full class name if found, false otherwise

     */

    protected function findClass($file)

    {

        $class = false;

        $namespace = false;

        $tokens = token_get_all(file_get_contents($file));

        while ($token = array_shift($tokens)) {

            if (!is_array($token)) {

                continue;

            }

            if (true === $class && T_STRING === $token[0]) {

                return $namespace.'\\'.$token[1];

            }

            if (true === $namespace && T_STRING === $token[0]) {

                $namespace = '';

                do {

                    $namespace .= $token[1];

                    $token = array_shift($tokens);

                } while ($tokens && is_array($token) && in_array($token[0], array(T_NS_SEPARATOR, T_STRING)));

            }

            if (T_CLASS === $token[0]) {

                $class = true;

            }

            if (T_NAMESPACE === $token[0]) {

                $namespace = true;

            }

        }

        return false;

    }

}