PHP Class Illuminate\Routing\Router

Inheritance: implements Illuminate\Contracts\Routing\Registrar, use trait Illuminate\Support\Traits\Macroable
Afficher le fichier Open project: illuminate/routing Class Usage Examples

Méthodes publiques

Свойство Type Description
$middlewarePriority array Forces the listed middleware to always be in the given order.
$verbs array All of the verbs supported by the router.

Protected Properties

Свойство Type Description
$binders array The registered route value binders.
$container Illuminate\Container\Container The IoC container instance.
$current Illuminate\Routing\Route The currently dispatched route instance.
$currentRequest Illuminate\Http\Request The request currently being dispatched.
$events Illuminate\Contracts\Events\Dispatcher The event dispatcher instance.
$groupStack array The route group attribute stack.
$middleware array All of the short-hand keys for middlewares.
$middlewareGroups array All of the middleware groups.
$patterns array The globally available parameter patterns.
$routes Illuminate\Routing\RouteCollection The route collection instance.

Méthodes publiques

Méthode Description
__construct ( Illuminate\Contracts\Events\Dispatcher $events, Illuminate\Container\Container $container = null ) : void Create a new Router instance.
any ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new route responding to all verbs.
auth ( ) : void Register the typical authentication routes for an application.
bind ( string $key, string | callable $binder ) : void Add a new route parameter binder.
createClassBinding ( string $binding ) : Closure Create a class based binding using the IoC container.
current ( ) : Illuminate\Routing\Route Get the currently dispatched route instance.
currentRouteAction ( ) : string | null Get the current route action.
currentRouteName ( ) : string | null Get the current route name.
currentRouteNamed ( string $name ) : boolean Determine if the current route matches a given name.
currentRouteUses ( string $action ) : boolean Determine if the current route action matches a given action.
delete ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new DELETE route with the router.
dispatch ( Illuminate\Http\Request $request ) : Illuminate\Http\Response Dispatch the request to the application.
dispatchToRoute ( Illuminate\Http\Request $request ) : mixed Dispatch the request to a route and return the response.
gatherRouteMiddleware ( Illuminate\Routing\Route $route ) : array Gather the middleware for the given route.
get ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new GET route with the router.
getBindingCallback ( string $key ) : Closure | null Get the binding callback for a given binding.
getCurrentRequest ( ) : Illuminate\Http\Request Get the request currently being dispatched.
getCurrentRoute ( ) : Illuminate\Routing\Route Get the currently dispatched route instance.
getGroupStack ( ) : array Get the current group stack for the router.
getLastGroupPrefix ( ) : string Get the prefix from the last group on the stack.
getMiddleware ( ) : array Get all of the defined middleware short-hand names.
getPatterns ( ) : array Get the global "where" patterns.
getRoutes ( ) : Illuminate\Routing\RouteCollection Get the underlying route collection.
group ( array $attributes, Closure $callback ) : void Create a route group with shared attributes.
has ( string $name ) : boolean Check if a route with the given name exists.
hasGroupStack ( ) : boolean Determine if the router currently has a group stack.
input ( string $key, string $default = null ) : mixed Get a route parameter for the current route.
is ( ) : boolean Alias for the "currentRouteNamed" method.
match ( array | string $methods, string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new route with the given verbs.
matched ( string | callable $callback ) : void Register a route matched event listener.
mergeGroup ( array $new, array $old ) : array Merge the given group attributes.
mergeWithLastGroup ( array $new ) : array Merge the given array with the last group stack.
middleware ( string $name, string $class ) Register a short-hand name for a middleware.
middlewareGroup ( string $name, array $middleware ) Register a group of middleware.
model ( string $key, string $class, Closure $callback = null ) : void Register a model binder for a wildcard.
options ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new OPTIONS route with the router.
patch ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new PATCH route with the router.
pattern ( string $key, string $pattern ) : void Set a global where pattern on all routes.
patterns ( array $patterns ) : void Set a group of global where patterns on all routes.
post ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new POST route with the router.
prepareResponse ( Request $request, mixed $response ) : Illuminate\Http\Response Create a response instance from the given value.
prependMiddlewareToGroup ( string $group, string $middleware ) Add a middleware to the beginning of a middleware group.
pushMiddlewareToGroup ( string $group, string $middleware ) Add a middleware to the end of a middleware group.
put ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route Register a new PUT route with the router.
resolveMiddlewareClassName ( string $name ) : string | array Resolve the middleware name to a class name(s) preserving passed parameters.
resource ( string $name, string $controller, array $options = [] ) : void Route a resource to a controller.
resourceParameters ( array $parameters = [] ) : void Set the global resource parameter mapping.
resources ( array $resources ) : void Register an array of resource controllers.
setRoutes ( Illuminate\Routing\RouteCollection $routes ) : void Set the route collection instance.
singularResourceParameters ( boolean $singular = true ) : void Set the unmapped global resource parameters to singular.
substituteBindings ( Illuminate\Routing\Route $route ) : Illuminate\Routing\Route Substitute the route bindings onto the route.
substituteImplicitBindings ( Illuminate\Routing\Route $route ) : void Substitute the implicit Eloquent model bindings for the route.
uses ( ) : boolean Alias for the "currentRouteUses" method.

Méthodes protégées

Méthode Description
actionReferencesController ( array $action ) : boolean Determine if the action is routing to a controller.
addRoute ( array | string $methods, string $uri, Closure | array | string | null $action ) : Illuminate\Routing\Route Add a route to the underlying route collection.
addWhereClausesToRoute ( Illuminate\Routing\Route $route ) : Illuminate\Routing\Route Add the necessary where clauses to the route based on its initial registration.
convertToControllerAction ( array | string $action ) : array Add a controller based route action to the action array.
createRoute ( array | string $methods, string $uri, mixed $action ) : Illuminate\Routing\Route Create a new route instance.
findRoute ( Illuminate\Http\Request $request ) : Illuminate\Routing\Route Find the route matching a given request.
formatGroupPrefix ( array $new, array $old ) : string | null Format the prefix for the new group attributes.
formatUsesPrefix ( array $new, array $old ) : string | null Format the uses prefix for the new group attributes.
mergeGroupAttributesIntoRoute ( Illuminate\Routing\Route $route ) : void Merge the group stack with the controller action.
newRoute ( array | string $methods, string $uri, mixed $action ) : Illuminate\Routing\Route Create a new Route object.
parseMiddlewareGroup ( string $name ) : array Parse the middleware group and format it for usage.
performBinding ( string $key, string $value, Illuminate\Routing\Route $route ) : mixed Call the binding callback for the given key.
prefix ( string $uri ) : string Prefix the given URI with the last prefix.
prependGroupUses ( string $uses ) : string Prepend the last group uses onto the use clause.
runRouteWithinStack ( Illuminate\Routing\Route $route, Illuminate\Http\Request $request ) : mixed Run the given route within a Stack "onion" instance.
sortMiddleware ( Collection $middlewares ) : array Sort the given middleware by priority.
updateGroupStack ( array $attributes ) : void Update the group stack with the given attributes.

Method Details

__construct() public méthode

Create a new Router instance.
public __construct ( Illuminate\Contracts\Events\Dispatcher $events, Illuminate\Container\Container $container = null ) : void
$events Illuminate\Contracts\Events\Dispatcher
$container Illuminate\Container\Container
Résultat void

actionReferencesController() protected méthode

Determine if the action is routing to a controller.
protected actionReferencesController ( array $action ) : boolean
$action array
Résultat boolean

addRoute() protected méthode

Add a route to the underlying route collection.
protected addRoute ( array | string $methods, string $uri, Closure | array | string | null $action ) : Illuminate\Routing\Route
$methods array | string
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

addWhereClausesToRoute() protected méthode

Add the necessary where clauses to the route based on its initial registration.
protected addWhereClausesToRoute ( Illuminate\Routing\Route $route ) : Illuminate\Routing\Route
$route Illuminate\Routing\Route
Résultat Illuminate\Routing\Route

any() public méthode

Register a new route responding to all verbs.
public any ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

auth() public méthode

Register the typical authentication routes for an application.
public auth ( ) : void
Résultat void

bind() public méthode

Add a new route parameter binder.
public bind ( string $key, string | callable $binder ) : void
$key string
$binder string | callable
Résultat void

convertToControllerAction() protected méthode

Add a controller based route action to the action array.
protected convertToControllerAction ( array | string $action ) : array
$action array | string
Résultat array

createClassBinding() public méthode

Create a class based binding using the IoC container.
public createClassBinding ( string $binding ) : Closure
$binding string
Résultat Closure

createRoute() protected méthode

Create a new route instance.
protected createRoute ( array | string $methods, string $uri, mixed $action ) : Illuminate\Routing\Route
$methods array | string
$uri string
$action mixed
Résultat Illuminate\Routing\Route

current() public méthode

Get the currently dispatched route instance.
public current ( ) : Illuminate\Routing\Route
Résultat Illuminate\Routing\Route

currentRouteAction() public méthode

Get the current route action.
public currentRouteAction ( ) : string | null
Résultat string | null

currentRouteName() public méthode

Get the current route name.
public currentRouteName ( ) : string | null
Résultat string | null

currentRouteNamed() public méthode

Determine if the current route matches a given name.
public currentRouteNamed ( string $name ) : boolean
$name string
Résultat boolean

currentRouteUses() public méthode

Determine if the current route action matches a given action.
public currentRouteUses ( string $action ) : boolean
$action string
Résultat boolean

delete() public méthode

Register a new DELETE route with the router.
public delete ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

dispatch() public méthode

Dispatch the request to the application.
public dispatch ( Illuminate\Http\Request $request ) : Illuminate\Http\Response
$request Illuminate\Http\Request
Résultat Illuminate\Http\Response

dispatchToRoute() public méthode

Dispatch the request to a route and return the response.
public dispatchToRoute ( Illuminate\Http\Request $request ) : mixed
$request Illuminate\Http\Request
Résultat mixed

findRoute() protected méthode

Find the route matching a given request.
protected findRoute ( Illuminate\Http\Request $request ) : Illuminate\Routing\Route
$request Illuminate\Http\Request
Résultat Illuminate\Routing\Route

formatGroupPrefix() protected static méthode

Format the prefix for the new group attributes.
protected static formatGroupPrefix ( array $new, array $old ) : string | null
$new array
$old array
Résultat string | null

formatUsesPrefix() protected static méthode

Format the uses prefix for the new group attributes.
protected static formatUsesPrefix ( array $new, array $old ) : string | null
$new array
$old array
Résultat string | null

gatherRouteMiddleware() public méthode

Gather the middleware for the given route.
public gatherRouteMiddleware ( Illuminate\Routing\Route $route ) : array
$route Illuminate\Routing\Route
Résultat array

get() public méthode

Register a new GET route with the router.
public get ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

getBindingCallback() public méthode

Get the binding callback for a given binding.
public getBindingCallback ( string $key ) : Closure | null
$key string
Résultat Closure | null

getCurrentRequest() public méthode

Get the request currently being dispatched.
public getCurrentRequest ( ) : Illuminate\Http\Request
Résultat Illuminate\Http\Request

getCurrentRoute() public méthode

Get the currently dispatched route instance.
public getCurrentRoute ( ) : Illuminate\Routing\Route
Résultat Illuminate\Routing\Route

getGroupStack() public méthode

Get the current group stack for the router.
public getGroupStack ( ) : array
Résultat array

getLastGroupPrefix() public méthode

Get the prefix from the last group on the stack.
public getLastGroupPrefix ( ) : string
Résultat string

getMiddleware() public méthode

Get all of the defined middleware short-hand names.
public getMiddleware ( ) : array
Résultat array

getPatterns() public méthode

Get the global "where" patterns.
public getPatterns ( ) : array
Résultat array

getRoutes() public méthode

Get the underlying route collection.
public getRoutes ( ) : Illuminate\Routing\RouteCollection
Résultat Illuminate\Routing\RouteCollection

group() public méthode

Create a route group with shared attributes.
public group ( array $attributes, Closure $callback ) : void
$attributes array
$callback Closure
Résultat void

has() public méthode

Check if a route with the given name exists.
public has ( string $name ) : boolean
$name string
Résultat boolean

hasGroupStack() public méthode

Determine if the router currently has a group stack.
public hasGroupStack ( ) : boolean
Résultat boolean

input() public méthode

Get a route parameter for the current route.
public input ( string $key, string $default = null ) : mixed
$key string
$default string
Résultat mixed

is() public méthode

Alias for the "currentRouteNamed" method.
public is ( ) : boolean
Résultat boolean

match() public méthode

Register a new route with the given verbs.
public match ( array | string $methods, string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$methods array | string
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

matched() public méthode

Register a route matched event listener.
public matched ( string | callable $callback ) : void
$callback string | callable
Résultat void

mergeGroup() public static méthode

Merge the given group attributes.
public static mergeGroup ( array $new, array $old ) : array
$new array
$old array
Résultat array

mergeGroupAttributesIntoRoute() protected méthode

Merge the group stack with the controller action.
protected mergeGroupAttributesIntoRoute ( Illuminate\Routing\Route $route ) : void
$route Illuminate\Routing\Route
Résultat void

mergeWithLastGroup() public méthode

Merge the given array with the last group stack.
public mergeWithLastGroup ( array $new ) : array
$new array
Résultat array

middleware() public méthode

Register a short-hand name for a middleware.
public middleware ( string $name, string $class )
$name string
$class string

middlewareGroup() public méthode

Register a group of middleware.
public middlewareGroup ( string $name, array $middleware )
$name string
$middleware array

model() public méthode

Register a model binder for a wildcard.
public model ( string $key, string $class, Closure $callback = null ) : void
$key string
$class string
$callback Closure
Résultat void

newRoute() protected méthode

Create a new Route object.
protected newRoute ( array | string $methods, string $uri, mixed $action ) : Illuminate\Routing\Route
$methods array | string
$uri string
$action mixed
Résultat Illuminate\Routing\Route

options() public méthode

Register a new OPTIONS route with the router.
public options ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

parseMiddlewareGroup() protected méthode

Parse the middleware group and format it for usage.
protected parseMiddlewareGroup ( string $name ) : array
$name string
Résultat array

patch() public méthode

Register a new PATCH route with the router.
public patch ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

pattern() public méthode

Set a global where pattern on all routes.
public pattern ( string $key, string $pattern ) : void
$key string
$pattern string
Résultat void

patterns() public méthode

Set a group of global where patterns on all routes.
public patterns ( array $patterns ) : void
$patterns array
Résultat void

performBinding() protected méthode

Call the binding callback for the given key.
protected performBinding ( string $key, string $value, Illuminate\Routing\Route $route ) : mixed
$key string
$value string
$route Illuminate\Routing\Route
Résultat mixed

post() public méthode

Register a new POST route with the router.
public post ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

prefix() protected méthode

Prefix the given URI with the last prefix.
protected prefix ( string $uri ) : string
$uri string
Résultat string

prepareResponse() public méthode

Create a response instance from the given value.
public prepareResponse ( Request $request, mixed $response ) : Illuminate\Http\Response
$request Symfony\Component\HttpFoundation\Request
$response mixed
Résultat Illuminate\Http\Response

prependGroupUses() protected méthode

Prepend the last group uses onto the use clause.
protected prependGroupUses ( string $uses ) : string
$uses string
Résultat string

prependMiddlewareToGroup() public méthode

If the middleware is already in the group, it will not be added again.
public prependMiddlewareToGroup ( string $group, string $middleware )
$group string
$middleware string

pushMiddlewareToGroup() public méthode

If the middleware is already in the group, it will not be added again.
public pushMiddlewareToGroup ( string $group, string $middleware )
$group string
$middleware string

put() public méthode

Register a new PUT route with the router.
public put ( string $uri, Closure | array | string | null $action = null ) : Illuminate\Routing\Route
$uri string
$action Closure | array | string | null
Résultat Illuminate\Routing\Route

resolveMiddlewareClassName() public méthode

Resolve the middleware name to a class name(s) preserving passed parameters.
public resolveMiddlewareClassName ( string $name ) : string | array
$name string
Résultat string | array

resource() public méthode

Route a resource to a controller.
public resource ( string $name, string $controller, array $options = [] ) : void
$name string
$controller string
$options array
Résultat void

resourceParameters() public méthode

Set the global resource parameter mapping.
public resourceParameters ( array $parameters = [] ) : void
$parameters array
Résultat void

resources() public méthode

Register an array of resource controllers.
public resources ( array $resources ) : void
$resources array
Résultat void

runRouteWithinStack() protected méthode

Run the given route within a Stack "onion" instance.
protected runRouteWithinStack ( Illuminate\Routing\Route $route, Illuminate\Http\Request $request ) : mixed
$route Illuminate\Routing\Route
$request Illuminate\Http\Request
Résultat mixed

setRoutes() public méthode

Set the route collection instance.
public setRoutes ( Illuminate\Routing\RouteCollection $routes ) : void
$routes Illuminate\Routing\RouteCollection
Résultat void

singularResourceParameters() public méthode

Set the unmapped global resource parameters to singular.
public singularResourceParameters ( boolean $singular = true ) : void
$singular boolean
Résultat void

sortMiddleware() protected méthode

Sort the given middleware by priority.
protected sortMiddleware ( Collection $middlewares ) : array
$middlewares Illuminate\Support\Collection
Résultat array

substituteBindings() public méthode

Substitute the route bindings onto the route.
public substituteBindings ( Illuminate\Routing\Route $route ) : Illuminate\Routing\Route
$route Illuminate\Routing\Route
Résultat Illuminate\Routing\Route

substituteImplicitBindings() public méthode

Substitute the implicit Eloquent model bindings for the route.
public substituteImplicitBindings ( Illuminate\Routing\Route $route ) : void
$route Illuminate\Routing\Route
Résultat void

updateGroupStack() protected méthode

Update the group stack with the given attributes.
protected updateGroupStack ( array $attributes ) : void
$attributes array
Résultat void

uses() public méthode

Alias for the "currentRouteUses" method.
public uses ( ) : boolean
Résultat boolean

Property Details

$binders protected_oe property

The registered route value binders.
protected array $binders
Résultat array

$container protected_oe property

The IoC container instance.
protected Container,Illuminate\Container $container
Résultat Illuminate\Container\Container

$current protected_oe property

The currently dispatched route instance.
protected Route,Illuminate\Routing $current
Résultat Illuminate\Routing\Route

$currentRequest protected_oe property

The request currently being dispatched.
protected Request,Illuminate\Http $currentRequest
Résultat Illuminate\Http\Request

$events protected_oe property

The event dispatcher instance.
protected Dispatcher,Illuminate\Contracts\Events $events
Résultat Illuminate\Contracts\Events\Dispatcher

$groupStack protected_oe property

The route group attribute stack.
protected array $groupStack
Résultat array

$middleware protected_oe property

All of the short-hand keys for middlewares.
protected array $middleware
Résultat array

$middlewareGroups protected_oe property

All of the middleware groups.
protected array $middlewareGroups
Résultat array

$middlewarePriority public_oe property

Forces the listed middleware to always be in the given order.
public array $middlewarePriority
Résultat array

$patterns protected_oe property

The globally available parameter patterns.
protected array $patterns
Résultat array

$routes protected_oe property

The route collection instance.
protected RouteCollection,Illuminate\Routing $routes
Résultat Illuminate\Routing\RouteCollection

$verbs public_oe static_oe property

All of the verbs supported by the router.
public static array $verbs
Résultat array