final class MiddlewareStack (View source)

Maintains the ordered middleware class list used to build the global HTTP pipeline.

Methods

__construct(array $middlewares = [])

Initializes a mutable stack from middleware class names in execution order.

add(string $middleware)

Appends middleware to the end of the execution order.

prepend(string $middleware)

Prepends middleware to the beginning of the execution order.

insertBefore(string $target, string $middleware)

Inserts middleware immediately before an existing target.

insertAfter(string $target, string $middleware)

Inserts middleware immediately after an existing target.

remove(string $middleware)

Removes every occurrence of a middleware class while preserving remaining order.

array
all()

Returns middleware class names in their current execution order.

array

Details

__construct

__construct(array $middlewares = [])

Initializes a mutable stack from middleware class names in execution order.

Parameters

array $middlewares

add

MiddlewareStack add(string $middleware)

Appends middleware to the end of the execution order.

Parameters

string $middleware

Return Value

MiddlewareStack

prepend

MiddlewareStack prepend(string $middleware)

Prepends middleware to the beginning of the execution order.

Parameters

string $middleware

Return Value

MiddlewareStack

insertBefore

MiddlewareStack insertBefore(string $target, string $middleware)

Inserts middleware immediately before an existing target.

Parameters

string $target
string $middleware

Return Value

MiddlewareStack

Exceptions

InvalidArgumentException

insertAfter

MiddlewareStack insertAfter(string $target, string $middleware)

Inserts middleware immediately after an existing target.

Parameters

string $target
string $middleware

Return Value

MiddlewareStack

Exceptions

InvalidArgumentException

remove

MiddlewareStack remove(string $middleware)

Removes every occurrence of a middleware class while preserving remaining order.

Parameters

string $middleware

Return Value

MiddlewareStack

all

array all()

Returns middleware class names in their current execution order.

Return Value

array