Chris@14: <?php
Chris@14: 
Chris@14: namespace Drupal\Core\Routing;
Chris@14: 
Chris@14: use Symfony\Component\Routing\Route;
Chris@14: 
Chris@14: /**
Chris@14:  * A backwards compatibility route.
Chris@14:  *
Chris@14:  * When a route is deprecated for another one, and backwards compatibility is
Chris@14:  * provided, then it's best practice to:
Chris@14:  * - not duplicate all route definition metadata, to instead have an "as empty
Chris@14:  *   as possible" route
Chris@14:  * - have an accompanying outbound route processor, that overwrites this empty
Chris@14:  *   route definition with the redirected route's definition.
Chris@14:  *
Chris@14:  * @see \Drupal\rest\RouteProcessor\RestResourceGetRouteProcessorBC
Chris@14:  */
Chris@14: class BcRoute extends Route {
Chris@14: 
Chris@14:   /**
Chris@14:    * {@inheritdoc}
Chris@14:    */
Chris@14:   public function __construct() {
Chris@14:     parent::__construct('');
Chris@14:     $this->setOption('bc_route', TRUE);
Chris@14:   }
Chris@14: 
Chris@14: }