annotate vendor/symfony/routing/Loader/Configurator/CollectionConfigurator.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 1fec387a4317
children
rev   line source
Chris@14 1 <?php
Chris@14 2
Chris@14 3 /*
Chris@14 4 * This file is part of the Symfony package.
Chris@14 5 *
Chris@14 6 * (c) Fabien Potencier <fabien@symfony.com>
Chris@14 7 *
Chris@14 8 * For the full copyright and license information, please view the LICENSE
Chris@14 9 * file that was distributed with this source code.
Chris@14 10 */
Chris@14 11
Chris@14 12 namespace Symfony\Component\Routing\Loader\Configurator;
Chris@14 13
Chris@14 14 use Symfony\Component\Routing\Route;
Chris@14 15 use Symfony\Component\Routing\RouteCollection;
Chris@14 16
Chris@14 17 /**
Chris@14 18 * @author Nicolas Grekas <p@tchwork.com>
Chris@14 19 */
Chris@14 20 class CollectionConfigurator
Chris@14 21 {
Chris@14 22 use Traits\AddTrait;
Chris@14 23 use Traits\RouteTrait;
Chris@14 24
Chris@14 25 private $parent;
Chris@14 26 private $parentConfigurator;
Chris@14 27
Chris@14 28 public function __construct(RouteCollection $parent, $name, self $parentConfigurator = null)
Chris@14 29 {
Chris@14 30 $this->parent = $parent;
Chris@14 31 $this->name = $name;
Chris@14 32 $this->collection = new RouteCollection();
Chris@14 33 $this->route = new Route('');
Chris@14 34 $this->parentConfigurator = $parentConfigurator; // for GC control
Chris@14 35 }
Chris@14 36
Chris@14 37 public function __destruct()
Chris@14 38 {
Chris@14 39 $this->collection->addPrefix(rtrim($this->route->getPath(), '/'));
Chris@14 40 $this->parent->addCollection($this->collection);
Chris@14 41 }
Chris@14 42
Chris@14 43 /**
Chris@14 44 * Adds a route.
Chris@14 45 *
Chris@14 46 * @param string $name
Chris@14 47 * @param string $path
Chris@14 48 *
Chris@14 49 * @return RouteConfigurator
Chris@14 50 */
Chris@14 51 final public function add($name, $path)
Chris@14 52 {
Chris@14 53 $this->collection->add($this->name.$name, $route = clone $this->route);
Chris@14 54
Chris@14 55 return new RouteConfigurator($this->collection, $route->setPath($path), $this->name, $this);
Chris@14 56 }
Chris@14 57
Chris@14 58 /**
Chris@14 59 * Creates a sub-collection.
Chris@14 60 *
Chris@14 61 * @return self
Chris@14 62 */
Chris@14 63 final public function collection($name = '')
Chris@14 64 {
Chris@14 65 return new self($this->collection, $this->name.$name, $this);
Chris@14 66 }
Chris@14 67
Chris@14 68 /**
Chris@14 69 * Sets the prefix to add to the path of all child routes.
Chris@14 70 *
Chris@14 71 * @param string $prefix
Chris@14 72 *
Chris@14 73 * @return $this
Chris@14 74 */
Chris@14 75 final public function prefix($prefix)
Chris@14 76 {
Chris@14 77 $this->route->setPath($prefix);
Chris@14 78
Chris@14 79 return $this;
Chris@14 80 }
Chris@14 81 }