class RouteSubscriber

Same name in this branch
  1. 10 core/modules/media/tests/modules/media_test_embed/src/Routing/RouteSubscriber.php \Drupal\media_test_embed\Routing\RouteSubscriber
  2. 10 core/modules/config_translation/src/Routing/RouteSubscriber.php \Drupal\config_translation\Routing\RouteSubscriber
  3. 10 core/modules/media_library/src/Routing/RouteSubscriber.php \Drupal\media_library\Routing\RouteSubscriber
  4. 10 core/modules/node/src/Routing/RouteSubscriber.php \Drupal\node\Routing\RouteSubscriber
  5. 10 core/modules/views/src/EventSubscriber/RouteSubscriber.php \Drupal\views\EventSubscriber\RouteSubscriber
  6. 10 core/modules/field_ui/src/Routing/RouteSubscriber.php \Drupal\field_ui\Routing\RouteSubscriber
  7. 10 core/modules/serialization/tests/modules/user_route_alter_test/src/Routing/RouteSubscriber.php \Drupal\user_route_alter_test\Routing\RouteSubscriber
Same name in other branches
  1. 9 core/modules/media/tests/modules/media_test_embed/src/Routing/RouteSubscriber.php \Drupal\media_test_embed\Routing\RouteSubscriber
  2. 9 core/modules/config_translation/src/Routing/RouteSubscriber.php \Drupal\config_translation\Routing\RouteSubscriber
  3. 9 core/modules/media_library/src/Routing/RouteSubscriber.php \Drupal\media_library\Routing\RouteSubscriber
  4. 9 core/modules/node/src/Routing/RouteSubscriber.php \Drupal\node\Routing\RouteSubscriber
  5. 9 core/modules/views/src/EventSubscriber/RouteSubscriber.php \Drupal\views\EventSubscriber\RouteSubscriber
  6. 9 core/modules/field_ui/src/Routing/RouteSubscriber.php \Drupal\field_ui\Routing\RouteSubscriber
  7. 8.9.x core/modules/media/tests/modules/media_test_ckeditor/src/Routing/RouteSubscriber.php \Drupal\media_test_ckeditor\Routing\RouteSubscriber
  8. 8.9.x core/modules/config_translation/src/Routing/RouteSubscriber.php \Drupal\config_translation\Routing\RouteSubscriber
  9. 8.9.x core/modules/media_library/src/Routing/RouteSubscriber.php \Drupal\media_library\Routing\RouteSubscriber
  10. 8.9.x core/modules/node/src/Routing/RouteSubscriber.php \Drupal\node\Routing\RouteSubscriber
  11. 8.9.x core/modules/views/src/EventSubscriber/RouteSubscriber.php \Drupal\views\EventSubscriber\RouteSubscriber
  12. 8.9.x core/modules/field_ui/src/Routing/RouteSubscriber.php \Drupal\field_ui\Routing\RouteSubscriber
  13. 8.9.x core/modules/path/src/Routing/RouteSubscriber.php \Drupal\path\Routing\RouteSubscriber
  14. 11.x core/modules/media/tests/modules/media_test_embed/src/Routing/RouteSubscriber.php \Drupal\media_test_embed\Routing\RouteSubscriber
  15. 11.x core/modules/config_translation/src/Routing/RouteSubscriber.php \Drupal\config_translation\Routing\RouteSubscriber
  16. 11.x core/modules/media_library/src/Routing/RouteSubscriber.php \Drupal\media_library\Routing\RouteSubscriber
  17. 11.x core/modules/node/src/Routing/RouteSubscriber.php \Drupal\node\Routing\RouteSubscriber
  18. 11.x core/modules/views/src/EventSubscriber/RouteSubscriber.php \Drupal\views\EventSubscriber\RouteSubscriber
  19. 11.x core/modules/field_ui/src/Routing/RouteSubscriber.php \Drupal\field_ui\Routing\RouteSubscriber
  20. 11.x core/modules/block_content/src/Routing/RouteSubscriber.php \Drupal\block_content\Routing\RouteSubscriber
  21. 11.x core/modules/serialization/tests/modules/user_route_alter_test/src/Routing/RouteSubscriber.php \Drupal\user_route_alter_test\Routing\RouteSubscriber

Subscriber for Block content BC routes.

Hierarchy

  • class \Drupal\Core\Routing\RouteSubscriberBase implements \Symfony\Component\EventDispatcher\EventSubscriberInterface
    • class \Drupal\block_content\Routing\RouteSubscriber extends \Drupal\Core\Routing\RouteSubscriberBase

Expanded class hierarchy of RouteSubscriber

1 string reference to 'RouteSubscriber'
block_content.services.yml in core/modules/block_content/block_content.services.yml
core/modules/block_content/block_content.services.yml
1 service uses RouteSubscriber
block_content.bc_subscriber in core/modules/block_content/block_content.services.yml
Drupal\block_content\Routing\RouteSubscriber

File

core/modules/block_content/src/Routing/RouteSubscriber.php, line 16

Namespace

Drupal\block_content\Routing
View source
class RouteSubscriber extends RouteSubscriberBase {
    
    /**
     * The entity type manager service.
     *
     * @var \Drupal\Core\Entity\EntityTypeManagerInterface
     */
    protected $entityTypeManager;
    
    /**
     * The module handler.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface
     */
    protected $moduleHandler;
    
    /**
     * The route collection for adding routes.
     *
     * @var \Symfony\Component\Routing\RouteCollection
     */
    protected $collection;
    
    /**
     * The current base path.
     *
     * @var string
     */
    protected $basePath;
    
    /**
     * The BC base path.
     *
     * @var string
     */
    protected $basePathBc;
    
    /**
     * The redirect controller.
     *
     * @var string
     */
    protected $controller;
    
    /**
     * Constructs a RouteSubscriber object.
     *
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
     *   The entity type manager service.
     * @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler
     *   The module handler.
     */
    public function __construct(EntityTypeManagerInterface $entity_type_manager, ModuleHandlerInterface $module_handler) {
        $this->entityTypeManager = $entity_type_manager;
        $this->moduleHandler = $module_handler;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function alterRoutes(RouteCollection $collection) {
        $this->collection = $collection;
        // @see block_content.routing.yml
        if ($this->setUpBaseRoute('entity.block_content_type.collection')) {
            $this->addRedirectRoute('block_content.type_add');
        }
        $entity_type = $this->entityTypeManager
            ->getDefinition('block_content');
        if ($this->setUpBaseRoute($entity_type->get('field_ui_base_route'))) {
            foreach ($this->childRoutes($entity_type) as $route_name) {
                $this->addRedirectRoute($route_name);
            }
        }
    }
    
    /**
     * Gets parameters from a base route and saves them in class variables.
     *
     * @param string $base_route_name
     *   The name of a base route that already has a BC variant.
     *
     * @return bool
     *   TRUE if all parameters are set, FALSE if not.
     */
    protected function setUpBaseRoute(string $base_route_name) : bool {
        $base_route = $this->collection
            ->get($base_route_name);
        $base_route_bc = $this->collection
            ->get("{$base_route_name}.bc");
        if (empty($base_route) || empty($base_route_bc)) {
            return FALSE;
        }
        $this->basePath = $base_route->getPath();
        $this->basePathBc = $base_route_bc->getPath();
        $this->controller = $base_route_bc->getDefault('_controller');
        if (empty($this->basePath) || empty($this->basePathBc) || empty($this->controller) || $this->basePathBc === $this->basePath) {
            return FALSE;
        }
        return TRUE;
    }
    
    /**
     * Adds a redirect route.
     *
     * @param string $route_name
     *   The name of a route whose path has changed.
     */
    protected function addRedirectRoute(string $route_name) : void {
        // Exit early if the BC route is already there.
        if (!empty($this->collection
            ->get("{$route_name}.bc"))) {
            return;
        }
        $route = $this->collection
            ->get($route_name);
        if (empty($route)) {
            return;
        }
        $new_path = $route->getPath();
        if (!str_starts_with($new_path, $this->basePath)) {
            return;
        }
        $bc_route = clone $route;
        // Set the path to what it was in earlier versions of Drupal.
        $bc_route->setPath($this->basePathBc . substr($new_path, strlen($this->basePath)));
        if ($bc_route->getPath() === $route->getPath()) {
            return;
        }
        // Replace the handler with the stored redirect controller.
        $defaults = array_diff_key($route->getDefaults(), array_flip([
            '_entity_form',
            '_entity_list',
            '_entity_view',
            '_form',
        ]));
        $defaults['_controller'] = $this->controller;
        $bc_route->setDefaults($defaults);
        $this->collection
            ->add("{$route_name}.bc", $bc_route);
    }
    
    /**
     * Creates a list of routes that need BC redirects.
     *
     * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
     *   The entity type.
     *
     * @return string[]
     *   A list of route names.
     */
    protected function childRoutes(EntityTypeInterface $entity_type) : array {
        $route_names = [];
        if ($field_ui_base_route = $entity_type->get('field_ui_base_route')) {
            $updated_routes = new RouteCollection();
            $updated_routes->add($field_ui_base_route, $this->collection
                ->get($field_ui_base_route));
            $event = new RouteBuildEvent($updated_routes);
            // Apply route subscribers that add routes based on field_ui_base_route,
            // in the order of their weights.
            $subscribers = [
                'field_ui' => 'field_ui.subscriber',
                'content_translation' => 'content_translation.subscriber',
            ];
            foreach ($subscribers as $module_name => $service_name) {
                if ($this->moduleHandler
                    ->moduleExists($module_name)) {
                    \Drupal::service($service_name)->onAlterRoutes($event);
                }
            }
            $updated_routes->remove($field_ui_base_route);
            $route_names = array_merge($route_names, array_keys($updated_routes->all()));
            $route_names = array_merge($route_names, [
                // @see \Drupal\config_translation\Routing\RouteSubscriber::alterRoutes()
"config_translation.item.add.{$field_ui_base_route}",
                "config_translation.item.edit.{$field_ui_base_route}",
                "config_translation.item.delete.{$field_ui_base_route}",
            ]);
        }
        if ($entity_type_id = $entity_type->getBundleEntityType()) {
            $route_names = array_merge($route_names, [
                // @see \Drupal\Core\Entity\Routing\DefaultHtmlRouteProvider::getRoutes()
"entity.{$entity_type_id}.delete_form",
                // @see \Drupal\config_translation\Routing\RouteSubscriber::alterRoutes()
"entity.{$entity_type_id}.config_translation_overview",
                // @see \Drupal\user\Entity\EntityPermissionsRouteProvider::getRoutes()
"entity.{$entity_type_id}.entity_permissions_form",
            ]);
        }
        if ($entity_id = $entity_type->id()) {
            $route_names = array_merge($route_names, [
                // @see \Drupal\config_translation\Routing\RouteSubscriber::alterRoutes()
"entity.field_config.config_translation_overview.{$entity_id}",
                "config_translation.item.add.entity.field_config.{$entity_id}_field_edit_form",
                "config_translation.item.edit.entity.field_config.{$entity_id}_field_edit_form",
                "config_translation.item.delete.entity.field_config.{$entity_id}_field_edit_form",
                // @see \Drupal\layout_builder\Plugin\SectionStorage\DefaultsSectionStorage::buildRoutes()
"layout_builder.defaults.{$entity_id}.disable",
                "layout_builder.defaults.{$entity_id}.discard_changes",
                "layout_builder.defaults.{$entity_id}.view",
            ]);
        }
        return $route_names;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function getSubscribedEvents() : array {
        $events = parent::getSubscribedEvents();
        // Go after ContentTranslationRouteSubscriber.
        $events[RoutingEvents::ALTER] = [
            'onAlterRoutes',
            -300,
        ];
        return $events;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
RouteSubscriber::$basePath protected property The current base path.
RouteSubscriber::$basePathBc protected property The BC base path.
RouteSubscriber::$collection protected property The route collection for adding routes.
RouteSubscriber::$controller protected property The redirect controller.
RouteSubscriber::$entityTypeManager protected property The entity type manager service.
RouteSubscriber::$moduleHandler protected property The module handler.
RouteSubscriber::addRedirectRoute protected function Adds a redirect route.
RouteSubscriber::alterRoutes protected function Alters existing routes for a specific collection. Overrides RouteSubscriberBase::alterRoutes
RouteSubscriber::childRoutes protected function Creates a list of routes that need BC redirects.
RouteSubscriber::getSubscribedEvents public static function Overrides RouteSubscriberBase::getSubscribedEvents
RouteSubscriber::setUpBaseRoute protected function Gets parameters from a base route and saves them in class variables.
RouteSubscriber::__construct public function Constructs a RouteSubscriber object.
RouteSubscriberBase::onAlterRoutes public function Delegates the route altering to self::alterRoutes(). 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.