RouteCollectionInterface.php

TLDR

The file RouteCollectionInterface.php contains an interface named RouteCollectionInterface in the Illuminate\Routing namespace. This interface defines methods for managing and retrieving routes in a collection.

Methods

add

Adds a Route instance to the collection.

refreshNameLookups

Refreshes the name look-up table in case any routes are named or overwritten.

refreshActionLookups

Refreshes the action look-up table in case any actions are overwritten with new controllers.

match

Finds the first route that matches a given request. Throws exceptions if no route is found or the method is not allowed.

get

Gets routes from the collection by the given method.

hasNamedRoute

Determines if the route collection contains a given named route.

getByName

Gets a route instance by its name.

getByAction

Gets a route instance by its controller action.

getRoutes

Gets all the routes in the collection.

getRoutesByMethod

Gets all the routes in the collection, grouped by their HTTP verb / method.

getRoutesByName

Gets all the routes in the collection, keyed by their name.

<?php

namespace Illuminate\Routing;

use Illuminate\Http\Request;

interface RouteCollectionInterface
{
    /**
     * Add a Route instance to the collection.
     *
     * @param  \Illuminate\Routing\Route  $route
     * @return \Illuminate\Routing\Route
     */
    public function add(Route $route);

    /**
     * Refresh the name look-up table.
     *
     * This is done in case any names are fluently defined or if routes are overwritten.
     *
     * @return void
     */
    public function refreshNameLookups();

    /**
     * Refresh the action look-up table.
     *
     * This is done in case any actions are overwritten with new controllers.
     *
     * @return void
     */
    public function refreshActionLookups();

    /**
     * Find the first route matching a given request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Routing\Route
     *
     * @throws \Symfony\Component\HttpKernel\Exception\MethodNotAllowedHttpException
     * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
     */
    public function match(Request $request);

    /**
     * Get routes from the collection by method.
     *
     * @param  string|null  $method
     * @return \Illuminate\Routing\Route[]
     */
    public function get($method = null);

    /**
     * Determine if the route collection contains a given named route.
     *
     * @param  string  $name
     * @return bool
     */
    public function hasNamedRoute($name);

    /**
     * Get a route instance by its name.
     *
     * @param  string  $name
     * @return \Illuminate\Routing\Route|null
     */
    public function getByName($name);

    /**
     * Get a route instance by its controller action.
     *
     * @param  string  $action
     * @return \Illuminate\Routing\Route|null
     */
    public function getByAction($action);

    /**
     * Get all of the routes in the collection.
     *
     * @return \Illuminate\Routing\Route[]
     */
    public function getRoutes();

    /**
     * Get all of the routes keyed by their HTTP verb / method.
     *
     * @return array
     */
    public function getRoutesByMethod();

    /**
     * Get all of the routes keyed by their name.
     *
     * @return \Illuminate\Routing\Route[]
     */
    public function getRoutesByName();
}