AnnotationFileLoader.php 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. <?php
  2. /*
  3. * This file is part of the Symfony package.
  4. *
  5. * (c) Fabien Potencier <fabien@symfony.com>
  6. *
  7. * For the full copyright and license information, please view the LICENSE
  8. * file that was distributed with this source code.
  9. */
  10. namespace Symfony\Component\Routing\Loader;
  11. use Symfony\Component\Config\FileLocatorInterface;
  12. use Symfony\Component\Config\Loader\FileLoader;
  13. use Symfony\Component\Config\Resource\FileResource;
  14. use Symfony\Component\Routing\RouteCollection;
  15. /**
  16. * AnnotationFileLoader loads routing information from annotations set
  17. * on a PHP class and its methods.
  18. *
  19. * @author Fabien Potencier <fabien@symfony.com>
  20. */
  21. class AnnotationFileLoader extends FileLoader
  22. {
  23. protected $loader;
  24. /**
  25. * @throws \RuntimeException
  26. */
  27. public function __construct(FileLocatorInterface $locator, AnnotationClassLoader $loader)
  28. {
  29. if (!\function_exists('token_get_all')) {
  30. throw new \LogicException('The Tokenizer extension is required for the routing annotation loaders.');
  31. }
  32. parent::__construct($locator);
  33. $this->loader = $loader;
  34. }
  35. /**
  36. * Loads from annotations from a file.
  37. *
  38. * @param string $file A PHP file path
  39. * @param string|null $type The resource type
  40. *
  41. * @return RouteCollection|null A RouteCollection instance
  42. *
  43. * @throws \InvalidArgumentException When the file does not exist or its routes cannot be parsed
  44. */
  45. public function load($file, string $type = null)
  46. {
  47. $path = $this->locator->locate($file);
  48. $collection = new RouteCollection();
  49. if ($class = $this->findClass($path)) {
  50. $refl = new \ReflectionClass($class);
  51. if ($refl->isAbstract()) {
  52. return null;
  53. }
  54. $collection->addResource(new FileResource($path));
  55. $collection->addCollection($this->loader->load($class, $type));
  56. }
  57. gc_mem_caches();
  58. return $collection;
  59. }
  60. /**
  61. * {@inheritdoc}
  62. */
  63. public function supports($resource, string $type = null)
  64. {
  65. return \is_string($resource) && 'php' === pathinfo($resource, PATHINFO_EXTENSION) && (!$type || 'annotation' === $type);
  66. }
  67. /**
  68. * Returns the full class name for the first class in the file.
  69. *
  70. * @return string|false Full class name if found, false otherwise
  71. */
  72. protected function findClass(string $file)
  73. {
  74. $class = false;
  75. $namespace = false;
  76. $tokens = token_get_all(file_get_contents($file));
  77. if (1 === \count($tokens) && T_INLINE_HTML === $tokens[0][0]) {
  78. throw new \InvalidArgumentException(sprintf('The file "%s" does not contain PHP code. Did you forgot to add the "<?php" start tag at the beginning of the file?', $file));
  79. }
  80. for ($i = 0; isset($tokens[$i]); ++$i) {
  81. $token = $tokens[$i];
  82. if (!isset($token[1])) {
  83. continue;
  84. }
  85. if (true === $class && T_STRING === $token[0]) {
  86. return $namespace.'\\'.$token[1];
  87. }
  88. if (true === $namespace && T_STRING === $token[0]) {
  89. $namespace = $token[1];
  90. while (isset($tokens[++$i][1]) && \in_array($tokens[$i][0], [T_NS_SEPARATOR, T_STRING])) {
  91. $namespace .= $tokens[$i][1];
  92. }
  93. $token = $tokens[$i];
  94. }
  95. if (T_CLASS === $token[0]) {
  96. // Skip usage of ::class constant and anonymous classes
  97. $skipClassToken = false;
  98. for ($j = $i - 1; $j > 0; --$j) {
  99. if (!isset($tokens[$j][1])) {
  100. break;
  101. }
  102. if (T_DOUBLE_COLON === $tokens[$j][0] || T_NEW === $tokens[$j][0]) {
  103. $skipClassToken = true;
  104. break;
  105. } elseif (!\in_array($tokens[$j][0], [T_WHITESPACE, T_DOC_COMMENT, T_COMMENT])) {
  106. break;
  107. }
  108. }
  109. if (!$skipClassToken) {
  110. $class = true;
  111. }
  112. }
  113. if (T_NAMESPACE === $token[0]) {
  114. $namespace = true;
  115. }
  116. }
  117. return false;
  118. }
  119. }