interface RouteBuilderInterface in Drupal 9

Rebuilds the route information and dumps it.

Rebuilding the route information is the process of gathering all routing data from .routing.yml files, creating a \Symfony\Component\Routing\RouteCollection object out of it, and dispatching that object as a \Drupal\Core\Routing\RouteBuildEvent to all registered listeners. After that, the \Symfony\Component\Routing\RouteCollection object is used to dump the data. Examples of a dump include filling up the routing table, auto-generating Apache mod_rewrite rules, or auto-generating a PHP matcher class.

Hierarchy

• interface \Drupal\Core\Routing\RouteBuilderInterface

See also

\Drupal\Core\Routing\MatcherDumperInterface

\Drupal\Core\Routing\RouteProviderInterface

Related topics

Routing API

Route page requests to code based on URLs.

5 files declare their use of RouteBuilderInterface

EntityOperations.php in core/modules/content_moderation/src/EntityOperations.php

MediaConfigSubscriber.php in core/modules/media/src/EventSubscriber/MediaConfigSubscriber.php

NodeAdminRouteSubscriber.php in core/modules/node/src/EventSubscriber/NodeAdminRouteSubscriber.php

SystemConfigSubscriber.php in core/modules/system/src/SystemConfigSubscriber.php

ThemeInstaller.php in core/lib/Drupal/Core/Extension/ThemeInstaller.php

File

core/lib/Drupal/Core/Routing/RouteBuilderInterface.php, line 22

Namespace

Drupal\Core\Routing

interface RouteBuilderInterface {

  /**
   * Rebuilds the route information and dumps it.
   *
   * @return bool
   *   Returns TRUE if the rebuild succeeds, FALSE otherwise.
   */
  public function rebuild();

  /**
   * Rebuilds the route information if necessary, and dumps it.
   *
   * @return bool
   *   Returns TRUE if the rebuild occurs, FALSE otherwise.
   */
  public function rebuildIfNeeded();

  /**
   * Sets the router to be rebuilt next time rebuildIfNeeded() is called.
   */
  public function setRebuildNeeded();

}

Members

Name	Modifiers	Type	Description	Overrides
RouteBuilderInterface::rebuild	public	function	Rebuilds the route information and dumps it.	2
RouteBuilderInterface::rebuildIfNeeded	public	function	Rebuilds the route information if necessary, and dumps it.	2
RouteBuilderInterface::setRebuildNeeded	public	function	Sets the router to be rebuilt next time rebuildIfNeeded() is called.	2