Router
class Router implements BindingRegistrar, Registrar mixin RouteRegistrar (View source)
Traits
Properties
| static protected array | $macros | The registered string macros. |
from Macroable |
| protected Dispatcher | $events | The event dispatcher instance. |
|
| protected Container | $container | The IoC container instance. |
|
| protected RouteCollectionInterface | $routes | The route collection instance. |
|
| protected Route|null | $current | The currently dispatched route instance. |
|
| protected Request | $currentRequest | The request currently being dispatched. |
|
| protected array | $middleware | All of the short-hand keys for middlewares. |
|
| protected array | $middlewareGroups | All of the middleware groups. |
|
| array | $middlewarePriority | The priority-sorted list of middleware. |
|
| protected array | $binders | The registered route value binders. |
|
| protected array | $patterns | The globally available parameter patterns. |
|
| protected array | $groupStack | The route group attribute stack. |
|
| protected array | $implicitBindingCallback | The registered custom implicit binding callback. |
|
| static string[] | $verbs | All of the verbs supported by the router. |
Methods
Mix another object into the class.
Dynamically handle calls to the class.
Dynamically handle calls into the router instance.
Call the given Closure with this instance then return the instance.
Register a new GET route with the router.
Register a new POST route with the router.
Register a new PUT route with the router.
Register a new PATCH route with the router.
Register a new DELETE route with the router.
Register a new OPTIONS route with the router.
Register a new route responding to all verbs.
Create a redirect from one URI to another.
Create a permanent redirect from one URI to another.
Register a new route that returns a view.
Register a new route with the given verbs.
Register an array of resource controllers.
Route a resource to a controller.
Register an array of API resource controllers.
Route an API resource to a controller.
Register an array of singleton resource controllers.
Route a singleton resource to a controller.
Register an array of API singleton resource controllers.
Route an API singleton resource to a controller.
Update the group stack with the given attributes.
Merge the given array with the last group stack.
Get the prefix from the last group on the stack.
Add a route to the underlying route collection.
Create a new route instance.
Determine if the action is routing to a controller.
Add a controller based route action to the action array.
Prepend the last group namespace onto the use clause.
Prepend the last group controller onto the use clause.
Prefix the given URI with the last prefix.
Add the necessary where clauses to the route based on its initial registration.
Return the response returned by the given route.
Run the given route within a Stack "onion" instance.
Gather the middleware for the given route with resolved class names.
Resolve a flat array of middleware classes from the provided array.
Create a response instance from the given value.
Static version of prepareResponse.
Substitute the implicit route bindings for the given route.
Register a callback to run after implicit bindings are substituted.
Call the binding callback for the given key.
Register a route matched event listener.
Get all of the defined middleware short-hand names.
Register a short-hand name for a middleware.
Check if a middlewareGroup with the given name exists.
Get all of the defined middleware groups.
Register a group of middleware.
Add a middleware to the beginning of a middleware group.
Add a middleware to the end of a middleware group.
Remove the given middleware from the specified group.
Flush the router's middleware groups.
Add a new route parameter binder.
Get the binding callback for a given binding.
Get the global "where" patterns.
Set a global where pattern on all routes.
Set a group of global where patterns on all routes.
Determine if the router currently has a group stack.
Get the current group stack for the router.
Get a route parameter for the current route.
Get the request currently being dispatched.
Get the currently dispatched route instance.
Check if a route with the given name exists.
Get the current route name.
Alias for the "currentRouteNamed" method.
Determine if the current route matches a pattern.
Get the current route action.
Alias for the "currentRouteUses" method.
Determine if the current route action matches a given action.
Set the unmapped global resource parameters to singular.
Set the global resource parameter mapping.
Get or set the verbs used in the resource URIs.
Get the underlying route collection.
Set the compiled route collection instance.
Remove any duplicate middleware from the given array.
Details
static void
macro(string $name, object|callable $macro)
Register a custom macro.
static void
mixin(object $mixin, bool $replace = true)
Mix another object into the class.
static bool
hasMacro(string $name)
Checks if macro is registered.
static void
flushMacros()
Flush the existing macros.
static mixed
__callStatic(string $method, array $parameters)
Dynamically handle calls to the class.
mixed
__call(string $method, array $parameters)
Dynamically handle calls into the router instance.
tap($callback = null)
Call the given Closure with this instance then return the instance.
void
__construct(Dispatcher $events, Container|null $container = null)
Create a new Router instance.
Route
get(string $uri, array|string|callable $action = null)
Register a new GET route with the router.
Route
post(string $uri, array|string|callable $action = null)
Register a new POST route with the router.
Route
put(string $uri, array|string|callable $action = null)
Register a new PUT route with the router.
Route
patch(string $uri, array|string|callable $action = null)
Register a new PATCH route with the router.
Route
delete(string $uri, array|string|callable $action = null)
Register a new DELETE route with the router.
Route
options(string $uri, array|string|callable $action = null)
Register a new OPTIONS route with the router.
Route
any(string $uri, array|string|callable|null $action = null)
Register a new route responding to all verbs.
Route
fallback(array|string|callable|null $action)
Register a new fallback route with the router.
Route
redirect(string $uri, string $destination, int $status = 302)
Create a redirect from one URI to another.
Route
permanentRedirect(string $uri, string $destination)
Create a permanent redirect from one URI to another.
Route
view(string $uri, string $view, array $data = [], int|array $status = 200, array $headers = [])
Register a new route that returns a view.
Route
match(array|string $methods, string $uri, array|string|callable $action = null)
Register a new route with the given verbs.
void
resources(array $resources, array $options = [])
Register an array of resource controllers.
PendingResourceRegistration
resource(string $name, string $controller, array $options = [])
Route a resource to a controller.
void
apiResources(array $resources, array $options = [])
Register an array of API resource controllers.
PendingResourceRegistration
apiResource(string $name, string $controller, array $options = [])
Route an API resource to a controller.
void
singletons(array $singletons, array $options = [])
Register an array of singleton resource controllers.
PendingSingletonResourceRegistration
singleton(string $name, string $controller, array $options = [])
Route a singleton resource to a controller.
void
apiSingletons(array $singletons, array $options = [])
Register an array of API singleton resource controllers.
PendingSingletonResourceRegistration
apiSingleton(string $name, string $controller, array $options = [])
Route an API singleton resource to a controller.
void
group(array $attributes, Closure|string $routes)
Create a route group with shared attributes.
protected void
updateGroupStack(array $attributes)
Update the group stack with the given attributes.
array
mergeWithLastGroup(array $new, bool $prependExistingPrefix = true)
Merge the given array with the last group stack.
protected void
loadRoutes(Closure|string $routes)
Load the provided routes.
string
getLastGroupPrefix()
Get the prefix from the last group on the stack.
Route
addRoute(array|string $methods, string $uri, array|string|callable|null $action)
Add a route to the underlying route collection.
protected Route
createRoute(array|string $methods, string $uri, mixed $action)
Create a new route instance.
protected bool
actionReferencesController(mixed $action)
Determine if the action is routing to a controller.
protected array
convertToControllerAction(array|string $action)
Add a controller based route action to the action array.
protected string
prependGroupNamespace(string $class)
Prepend the last group namespace onto the use clause.
protected string
prependGroupController(string $class)
Prepend the last group controller onto the use clause.
Route
newRoute(array|string $methods, string $uri, mixed $action)
Create a new Route object.
protected string
prefix(string $uri)
Prefix the given URI with the last prefix.
protected Route
addWhereClausesToRoute(Route $route)
Add the necessary where clauses to the route based on its initial registration.
protected void
mergeGroupAttributesIntoRoute(Route $route)
Merge the group stack with the controller action.
Response
respondWithRoute(string $name)
Return the response returned by the given route.
Response
dispatch(Request $request)
Dispatch the request to the application.
Response
dispatchToRoute(Request $request)
Dispatch the request to a route and return the response.
protected Response
runRoute(Request $request, Route $route)
Return the response for the given route.
protected mixed
runRouteWithinStack(Route $route, Request $request)
Run the given route within a Stack "onion" instance.
array
gatherRouteMiddleware(Route $route)
Gather the middleware for the given route with resolved class names.
array
resolveMiddleware(array $middleware, array $excluded = [])
Resolve a flat array of middleware classes from the provided array.
protected array
sortMiddleware(Collection $middlewares)
Sort the given middleware by priority.
Response
prepareResponse(Request $request, mixed $response)
Create a response instance from the given value.
static Response
toResponse(Request $request, mixed $response)
Static version of prepareResponse.
void
substituteImplicitBindings(Route $route)
Substitute the implicit route bindings for the given route.
$this
substituteImplicitBindingsUsing(callable $callback)
Register a callback to run after implicit bindings are substituted.
protected mixed
performBinding(string $key, string $value, Route $route)
Call the binding callback for the given key.
void
matched(string|callable $callback)
Register a route matched event listener.
array
getMiddleware()
Get all of the defined middleware short-hand names.
$this
aliasMiddleware(string $name, string $class)
Register a short-hand name for a middleware.
bool
hasMiddlewareGroup(string $name)
Check if a middlewareGroup with the given name exists.
array
getMiddlewareGroups()
Get all of the defined middleware groups.
$this
middlewareGroup(string $name, array $middleware)
Register a group of middleware.
$this
prependMiddlewareToGroup(string $group, string $middleware)
Add a middleware to the beginning of a middleware group.
If the middleware is already in the group, it will not be added again.
$this
pushMiddlewareToGroup(string $group, string $middleware)
Add a middleware to the end of a middleware group.
If the middleware is already in the group, it will not be added again.
$this
removeMiddlewareFromGroup(string $group, string $middleware)
Remove the given middleware from the specified group.
$this
flushMiddlewareGroups()
Flush the router's middleware groups.
void
bind(string $key, string|callable $binder)
Add a new route parameter binder.
void
model(string $key, string $class, Closure|null $callback = null)
Register a model binder for a wildcard.
Closure
getBindingCallback(string $key)
Get the binding callback for a given binding.
array
getPatterns()
Get the global "where" patterns.
void
pattern(string $key, string $pattern)
Set a global where pattern on all routes.
void
patterns(array $patterns)
Set a group of global where patterns on all routes.
bool
hasGroupStack()
Determine if the router currently has a group stack.
array
getGroupStack()
Get the current group stack for the router.
mixed
input(string $key, string|null $default = null)
Get a route parameter for the current route.
Request
getCurrentRequest()
Get the request currently being dispatched.
Route|null
getCurrentRoute()
Get the currently dispatched route instance.
Route|null
current()
Get the currently dispatched route instance.
bool
has(string|array $name)
Check if a route with the given name exists.
string|null
currentRouteName()
Get the current route name.
bool
is(mixed ...$patterns)
Alias for the "currentRouteNamed" method.
bool
currentRouteNamed(mixed ...$patterns)
Determine if the current route matches a pattern.
string|null
currentRouteAction()
Get the current route action.
bool
uses(array|string ...$patterns)
Alias for the "currentRouteUses" method.
bool
currentRouteUses(string $action)
Determine if the current route action matches a given action.
void
singularResourceParameters(bool $singular = true)
Set the unmapped global resource parameters to singular.
void
resourceParameters(array $parameters = [])
Set the global resource parameter mapping.
array|null
resourceVerbs(array $verbs = [])
Get or set the verbs used in the resource URIs.
RouteCollectionInterface
getRoutes()
Get the underlying route collection.
void
setRoutes(RouteCollection $routes)
Set the route collection instance.
void
setCompiledRoutes(array $routes)
Set the compiled route collection instance.
static array
uniqueMiddleware(array $middleware)
Remove any duplicate middleware from the given array.
$this
setContainer(Container $container)
Set the container instance used by the router.