RouteProviderInterface.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/Routing/RouteProviderInterface.php
  2. 10 core/lib/Drupal/Core/Routing/RouteProviderInterface.php
  3. 11.x core/lib/Drupal/Core/Routing/RouteProviderInterface.php

Namespace

Drupal\Core\Routing

File

core/lib/Drupal/Core/Routing/RouteProviderInterface.php

View source
<?php

namespace Drupal\Core\Routing;

use Symfony\Cmf\Component\Routing\RouteProviderInterface as RouteProviderBaseInterface;

/**
 * Extends the router provider interface
 *
 * @see \Symfony\Cmf\Component\Routing
 */
interface RouteProviderInterface extends RouteProviderBaseInterface {
    
    /**
     * Get all routes which match a certain pattern.
     *
     * @param string $pattern
     *   The route pattern to search for (contains {} as placeholders).
     *
     * @return \Symfony\Component\Routing\RouteCollection
     *   Returns a route collection of matching routes. The collection may be
     *   empty and will be sorted from highest to lowest fit (match of path parts)
     *   and then in ascending order by route name for routes with the same fit.
     */
    public function getRoutesByPattern($pattern);
    
    /**
     * Returns all the routes on the system.
     *
     * Usage of this method is discouraged for performance reasons. If possible,
     * use RouteProviderInterface::getRoutesByNames() or
     * RouteProviderInterface::getRoutesByPattern() instead.
     *
     * @return \Symfony\Component\Routing\Route[]
     *   An iterator of routes keyed by route name.
     */
    public function getAllRoutes();
    
    /**
     * Resets the route provider object.
     */
    public function reset();

}

Interfaces

Title Deprecated Summary
RouteProviderInterface Extends the router provider interface

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