Файл: vendor/laravel/framework/src/Illuminate/Foundation/Configuration/Middleware.php
Строк: 683
<?php
namespace IlluminateFoundationConfiguration;
use Closure;
use IlluminateAuthAuthenticationException;
use IlluminateAuthMiddlewareAuthenticate;
use IlluminateAuthMiddlewareRedirectIfAuthenticated;
use IlluminateCookieMiddlewareEncryptCookies;
use IlluminateFoundationHttpMiddlewareConvertEmptyStringsToNull;
use IlluminateFoundationHttpMiddlewarePreventRequestForgery;
use IlluminateFoundationHttpMiddlewarePreventRequestsDuringMaintenance;
use IlluminateFoundationHttpMiddlewareTrimStrings;
use IlluminateHttpMiddlewareTrustHosts;
use IlluminateHttpMiddlewareTrustProxies;
use IlluminateRoutingMiddlewareValidateSignature;
use IlluminateSessionMiddlewareAuthenticateSession;
use IlluminateSupportArr;
use IlluminateSupportCollection;
class Middleware
{
/**
* The user defined global middleware stack.
*
* @var array
*/
protected $global = [];
/**
* The middleware that should be prepended to the global middleware stack.
*
* @var array
*/
protected $prepends = [];
/**
* The middleware that should be appended to the global middleware stack.
*
* @var array
*/
protected $appends = [];
/**
* The middleware that should be removed from the global middleware stack.
*
* @var array
*/
protected $removals = [];
/**
* The middleware that should be replaced in the global middleware stack.
*
* @var array
*/
protected $replacements = [];
/**
* The user defined middleware groups.
*
* @var array
*/
protected $groups = [];
/**
* The middleware that should be prepended to the specified groups.
*
* @var array
*/
protected $groupPrepends = [];
/**
* The middleware that should be appended to the specified groups.
*
* @var array
*/
protected $groupAppends = [];
/**
* The middleware that should be removed from the specified groups.
*
* @var array
*/
protected $groupRemovals = [];
/**
* The middleware that should be replaced in the specified groups.
*
* @var array
*/
protected $groupReplacements = [];
/**
* The Folio / page middleware for the application.
*
* @var array
*/
protected $pageMiddleware = [];
/**
* Indicates if the "trust hosts" middleware is enabled.
*
* @var bool
*/
protected $trustHosts = false;
/**
* Indicates if Sanctum's frontend state middleware is enabled.
*
* @var bool
*/
protected $statefulApi = false;
/**
* Indicates the API middleware group's rate limiter.
*
* @var string
*/
protected $apiLimiter;
/**
* Indicates if Redis throttling should be applied.
*
* @var bool
*/
protected $throttleWithRedis = false;
/**
* Indicates if sessions should be authenticated for the "web" middleware group.
*
* @var bool
*/
protected $authenticatedSessions = false;
/**
* The custom middleware aliases.
*
* @var array
*/
protected $customAliases = [];
/**
* The custom middleware priority definition.
*
* @var array
*/
protected $priority = [];
/**
* The middleware to prepend to the middleware priority definition.
*
* @var array
*/
protected $prependPriority = [];
/**
* The middleware to append to the middleware priority definition.
*
* @var array
*/
protected $appendPriority = [];
/**
* Prepend middleware to the application's global middleware stack.
*
* @param array|string $middleware
* @return $this
*/
public function prepend(array|string $middleware)
{
$this->prepends = array_merge(
Arr::wrap($middleware),
$this->prepends
);
return $this;
}
/**
* Append middleware to the application's global middleware stack.
*
* @param array|string $middleware
* @return $this
*/
public function append(array|string $middleware)
{
$this->appends = array_merge(
$this->appends,
Arr::wrap($middleware)
);
return $this;
}
/**
* Remove middleware from the application's global middleware stack.
*
* @param array|string $middleware
* @return $this
*/
public function remove(array|string $middleware)
{
$this->removals = array_merge(
$this->removals,
Arr::wrap($middleware)
);
return $this;
}
/**
* Specify a middleware that should be replaced with another middleware.
*
* @param string $search
* @param string $replace
* @return $this
*/
public function replace(string $search, string $replace)
{
$this->replacements[$search] = $replace;
return $this;
}
/**
* Define the global middleware for the application.
*
* @param array $middleware
* @return $this
*/
public function use(array $middleware)
{
$this->global = $middleware;
return $this;
}
/**
* Define a middleware group.
*
* @param string $group
* @param array $middleware
* @return $this
*/
public function group(string $group, array $middleware)
{
$this->groups[$group] = $middleware;
return $this;
}
/**
* Prepend the given middleware to the specified group.
*
* @param string $group
* @param array|string $middleware
* @return $this
*/
public function prependToGroup(string $group, array|string $middleware)
{
$this->groupPrepends[$group] = array_merge(
Arr::wrap($middleware),
$this->groupPrepends[$group] ?? []
);
return $this;
}
/**
* Append the given middleware to the specified group.
*
* @param string $group
* @param array|string $middleware
* @return $this
*/
public function appendToGroup(string $group, array|string $middleware)
{
$this->groupAppends[$group] = array_merge(
$this->groupAppends[$group] ?? [],
Arr::wrap($middleware)
);
return $this;
}
/**
* Remove the given middleware from the specified group.
*
* @param string $group
* @param array|string $middleware
* @return $this
*/
public function removeFromGroup(string $group, array|string $middleware)
{
$this->groupRemovals[$group] = array_merge(
Arr::wrap($middleware),
$this->groupRemovals[$group] ?? []
);
return $this;
}
/**
* Replace the given middleware in the specified group with another middleware.
*
* @param string $group
* @param string $search
* @param string $replace
* @return $this
*/
public function replaceInGroup(string $group, string $search, string $replace)
{
$this->groupReplacements[$group][$search] = $replace;
return $this;
}
/**
* Modify the middleware in the "web" group.
*
* @param array|string $append
* @param array|string $prepend
* @param array|string $remove
* @param array $replace
* @return $this
*/
public function web(array|string $append = [], array|string $prepend = [], array|string $remove = [], array $replace = [])
{
return $this->modifyGroup('web', $append, $prepend, $remove, $replace);
}
/**
* Modify the middleware in the "api" group.
*
* @param array|string $append
* @param array|string $prepend
* @param array|string $remove
* @param array $replace
* @return $this
*/
public function api(array|string $append = [], array|string $prepend = [], array|string $remove = [], array $replace = [])
{
return $this->modifyGroup('api', $append, $prepend, $remove, $replace);
}
/**
* Modify the middleware in the given group.
*
* @param string $group
* @param array|string $append
* @param array|string $prepend
* @param array|string $remove
* @param array $replace
* @return $this
*/
protected function modifyGroup(string $group, array|string $append, array|string $prepend, array|string $remove, array $replace)
{
if (! empty($append)) {
$this->appendToGroup($group, $append);
}
if (! empty($prepend)) {
$this->prependToGroup($group, $prepend);
}
if (! empty($remove)) {
$this->removeFromGroup($group, $remove);
}
if (! empty($replace)) {
foreach ($replace as $search => $replace) {
$this->replaceInGroup($group, $search, $replace);
}
}
return $this;
}
/**
* Register the Folio / page middleware for the application.
*
* @param array $middleware
* @return $this
*/
public function pages(array $middleware)
{
$this->pageMiddleware = $middleware;
return $this;
}
/**
* Register additional middleware aliases.
*
* @param array $aliases
* @return $this
*/
public function alias(array $aliases)
{
$this->customAliases = $aliases;
return $this;
}
/**
* Define the middleware priority for the application.
*
* @param array $priority
* @return $this
*/
public function priority(array $priority)
{
$this->priority = $priority;
return $this;
}
/**
* Prepend middleware to the priority middleware.
*
* @param array|string $before
* @param string $prepend
* @return $this
*/
public function prependToPriorityList($before, $prepend)
{
$this->prependPriority[$prepend] = $before;
return $this;
}
/**
* Append middleware to the priority middleware.
*
* @param array|string $after
* @param string $append
* @return $this
*/
public function appendToPriorityList($after, $append)
{
$this->appendPriority[$append] = $after;
return $this;
}
/**
* Get the global middleware.
*
* @return array
*/
public function getGlobalMiddleware()
{
$middleware = $this->global ?: array_values(array_filter([
IlluminateHttpMiddlewareValidatePathEncoding::class,
IlluminateFoundationHttpMiddlewareInvokeDeferredCallbacks::class,
$this->trustHosts ? IlluminateHttpMiddlewareTrustHosts::class : null,
IlluminateHttpMiddlewareTrustProxies::class,
IlluminateHttpMiddlewareHandleCors::class,
IlluminateFoundationHttpMiddlewarePreventRequestsDuringMaintenance::class,
IlluminateHttpMiddlewareValidatePostSize::class,
IlluminateFoundationHttpMiddlewareTrimStrings::class,
IlluminateFoundationHttpMiddlewareConvertEmptyStringsToNull::class,
]));
$middleware = array_map(function ($middleware) {
return $this->replacements[$middleware] ?? $middleware;
}, $middleware);
return array_values(array_filter(
array_diff(
array_unique(array_merge($this->prepends, $middleware, $this->appends)),
$this->removals
)
));
}
/**
* Get the middleware groups.
*
* @return array
*/
public function getMiddlewareGroups()
{
$middleware = [
'web' => array_values(array_filter([
IlluminateCookieMiddlewareEncryptCookies::class,
IlluminateCookieMiddlewareAddQueuedCookiesToResponse::class,
IlluminateSessionMiddlewareStartSession::class,
IlluminateViewMiddlewareShareErrorsFromSession::class,
IlluminateFoundationHttpMiddlewarePreventRequestForgery::class,
IlluminateRoutingMiddlewareSubstituteBindings::class,
$this->authenticatedSessions ? 'auth.session' : null,
])),
'api' => array_values(array_filter([
$this->statefulApi ? LaravelSanctumHttpMiddlewareEnsureFrontendRequestsAreStateful::class : null,
$this->apiLimiter ? 'throttle:'.$this->apiLimiter : null,
IlluminateRoutingMiddlewareSubstituteBindings::class,
])),
];
$middleware = array_merge($middleware, $this->groups);
foreach ($middleware as $group => $groupedMiddleware) {
foreach ($groupedMiddleware as $index => $groupMiddleware) {
if (isset($this->groupReplacements[$group][$groupMiddleware])) {
$middleware[$group][$index] = $this->groupReplacements[$group][$groupMiddleware];
}
}
}
foreach ($this->groupRemovals as $group => $removals) {
$middleware[$group] = array_values(array_filter(
array_diff($middleware[$group] ?? [], $removals)
));
}
foreach ($this->groupPrepends as $group => $prepends) {
$middleware[$group] = array_values(array_filter(
array_unique(array_merge($prepends, $middleware[$group] ?? []))
));
}
foreach ($this->groupAppends as $group => $appends) {
$middleware[$group] = array_values(array_filter(
array_unique(array_merge($middleware[$group] ?? [], $appends))
));
}
return $middleware;
}
/**
* Configure where guests are redirected by the "auth" middleware.
*
* @param callable|string|null $redirect
* @return $this
*/
public function redirectGuestsTo(callable|string|null $redirect)
{
if (is_null($redirect)) {
$redirect = fn () => null;
}
return $this->redirectTo(guests: $redirect);
}
/**
* Configure where users are redirected by the "guest" middleware.
*
* @param callable|string $redirect
* @return $this
*/
public function redirectUsersTo(callable|string $redirect)
{
return $this->redirectTo(users: $redirect);
}
/**
* Configure where users are redirected by the authentication and guest middleware.
*
* @param callable|string|null $guests
* @param callable|string|null $users
* @return $this
*/
public function redirectTo(callable|string|null $guests = null, callable|string|null $users = null)
{
$guests = is_string($guests) ? fn () => $guests : $guests;
$users = is_string($users) ? fn () => $users : $users;
if ($guests) {
Authenticate::redirectUsing($guests);
AuthenticateSession::redirectUsing($guests);
AuthenticationException::redirectUsing($guests);
}
if ($users) {
RedirectIfAuthenticated::redirectUsing($users);
}
return $this;
}
/**
* Configure the cookie encryption middleware.
*
* @param array<int, string> $except
* @return $this
*/
public function encryptCookies(array $except = [])
{
EncryptCookies::except($except);
return $this;
}
/**
* Configure the request forgery prevention middleware.
*
* @param array $except
* @param bool $originOnly
* @param bool $allowSameSite
* @return $this
*/
public function preventRequestForgery(array $except = [], bool $originOnly = false, bool $allowSameSite = false)
{
if (! empty($except)) {
PreventRequestForgery::except($except);
}
PreventRequestForgery::useOriginOnly($originOnly);
PreventRequestForgery::allowSameSite($allowSameSite);
return $this;
}
/**
* Configure the CSRF token validation middleware.
*
* @deprecated Use preventRequestForgery() instead.
*
* @param array $except
* @return $this
*/
public function validateCsrfTokens(array $except = [])
{
return $this->preventRequestForgery($except);
}
/**
* Configure the URL signature validation middleware.
*
* @param array $except
* @return $this
*/
public function validateSignatures(array $except = [])
{
ValidateSignature::except($except);
return $this;
}
/**
* Configure the empty string conversion middleware.
*
* @param array<int, (Closure(IlluminateHttpRequest): bool)> $except
* @return $this
*/
public function convertEmptyStringsToNull(array $except = [])
{
(new Collection($except))->each(fn (Closure $callback) => ConvertEmptyStringsToNull::skipWhen($callback));
return $this;
}
/**
* Configure the string trimming middleware.
*
* @param array<int, (Closure(IlluminateHttpRequest): bool)|string> $except
* @return $this
*/
public function trimStrings(array $except = [])
{
[$skipWhen, $except] = (new Collection($except))->partition(fn ($value) => $value instanceof Closure);
$skipWhen->each(fn (Closure $callback) => TrimStrings::skipWhen($callback));
TrimStrings::except($except->all());
return $this;
}
/**
* Indicate that the trusted host middleware should be enabled.
*
* @param array<int, string>|(callable(): array<int, string>)|null $at
* @param bool $subdomains
* @return $this
*/
public function trustHosts(array|callable|null $at = null, bool $subdomains = true)
{
$this->trustHosts = true;
if (! is_null($at)) {
TrustHosts::at($at, $subdomains);
}
return $this;
}
/**
* Configure the trusted proxies for the application.
*
* @param array<int, string>|string|null $at
* @param int|null $headers
* @return $this
*/
public function trustProxies(array|string|null $at = null, ?int $headers = null)
{
if (! is_null($at)) {
TrustProxies::at($at);
}
if (! is_null($headers)) {
TrustProxies::withHeaders($headers);
}
return $this;
}
/**
* Configure the middleware that prevents requests during maintenance mode.
*
* @param array<int, string> $except
* @return $this
*/
public function preventRequestsDuringMaintenance(array $except = [])
{
PreventRequestsDuringMaintenance::except($except);
return $this;
}
/**
* Indicate that Sanctum's frontend state middleware should be enabled.
*
* @return $this
*/
public function statefulApi()
{
$this->statefulApi = true;
return $this;
}
/**
* Indicate that the API middleware group's throttling middleware should be enabled.
*
* @param string $limiter
* @param bool $redis
* @return $this
*/
public function throttleApi($limiter = 'api', $redis = false)
{
$this->apiLimiter = $limiter;
if ($redis) {
$this->throttleWithRedis();
}
return $this;
}
/**
* Indicate that Laravel's throttling middleware should use Redis.
*
* @return $this
*/
public function throttleWithRedis()
{
$this->throttleWithRedis = true;
return $this;
}
/**
* Indicate that sessions should be authenticated for the "web" middleware group.
*
* @return $this
*/
public function authenticateSessions()
{
$this->authenticatedSessions = true;
return $this;
}
/**
* Get the Folio / page middleware for the application.
*
* @return array
*/
public function getPageMiddleware()
{
return $this->pageMiddleware;
}
/**
* Get the middleware aliases.
*
* @return array
*/
public function getMiddlewareAliases()
{
return array_merge($this->defaultAliases(), $this->customAliases);
}
/**
* Get the default middleware aliases.
*
* @return array
*/
protected function defaultAliases()
{
$aliases = [
'auth' => IlluminateAuthMiddlewareAuthenticate::class,
'auth.basic' => IlluminateAuthMiddlewareAuthenticateWithBasicAuth::class,
'auth.session' => IlluminateSessionMiddlewareAuthenticateSession::class,
'cache.headers' => IlluminateHttpMiddlewareSetCacheHeaders::class,
'can' => IlluminateAuthMiddlewareAuthorize::class,
'guest' => IlluminateAuthMiddlewareRedirectIfAuthenticated::class,
'password.confirm' => IlluminateAuthMiddlewareRequirePassword::class,
'precognitive' => IlluminateFoundationHttpMiddlewareHandlePrecognitiveRequests::class,
'signed' => IlluminateRoutingMiddlewareValidateSignature::class,
'throttle' => $this->throttleWithRedis
? IlluminateRoutingMiddlewareThrottleRequestsWithRedis::class
: IlluminateRoutingMiddlewareThrottleRequests::class,
'verified' => IlluminateAuthMiddlewareEnsureEmailIsVerified::class,
];
if (class_exists(SparkHttpMiddlewareVerifyBillableIsSubscribed::class)) {
$aliases['subscribed'] = SparkHttpMiddlewareVerifyBillableIsSubscribed::class;
}
return $aliases;
}
/**
* Get the middleware priority for the application.
*
* @return array
*/
public function getMiddlewarePriority()
{
return $this->priority;
}
/**
* Get the middleware to prepend to the middleware priority definition.
*
* @return array
*/
public function getMiddlewarePriorityPrepends()
{
return $this->prependPriority;
}
/**
* Get the middleware to append to the middleware priority definition.
*
* @return array
*/
public function getMiddlewarePriorityAppends()
{
return $this->appendPriority;
}
}