ExceptionEvent
extends RequestEvent
in package
Allows to create a response for a thrown exception.
Call setResponse() to set the response that will be returned for the current request. The propagation of this event is stopped as soon as a response is set.
You can also call setThrowable() to replace the thrown exception. This exception will be thrown if no response is set during processing of this event.
Tags
Table of Contents
- $allowCustomResponseCode : bool
- $kernel : mixed
- $propagationStopped : mixed
- $request : mixed
- $requestType : mixed
- $response : mixed
- $throwable : mixed
- __construct() : mixed
- allowCustomResponseCode() : void
- Mark the event as allowing a custom response code.
- getKernel() : HttpKernelInterface
- Returns the kernel in which this event was thrown.
- getRequest() : Request
- Returns the request the kernel is currently processing.
- getRequestType() : int
- Returns the request type the kernel is currently processing.
- getResponse() : Response|null
- Returns the response object.
- getThrowable() : Throwable
- hasResponse() : bool
- Returns whether a response was set.
- isAllowingCustomResponseCode() : bool
- Returns true if the event allows a custom response code.
- isMainRequest() : bool
- Checks if this is the main request.
- isMasterRequest() : bool
- Checks if this is a master request.
- isPropagationStopped() : bool
- Is propagation stopped?
- setResponse() : mixed
- Sets a response and stops event propagation.
- setThrowable() : void
- Replaces the thrown exception.
- stopPropagation() : void
- Stops the propagation of the event to further event listeners.
Properties
$allowCustomResponseCode
private
bool
$allowCustomResponseCode
= false
$kernel
private
mixed
$kernel
$propagationStopped
private
mixed
$propagationStopped
= false
$request
private
mixed
$request
$requestType
private
mixed
$requestType
$response
private
mixed
$response
$throwable
private
mixed
$throwable
Methods
__construct()
public
__construct(HttpKernelInterface $kernel, Request $request, int $requestType, Throwable $e) : mixed
Parameters
- $kernel : HttpKernelInterface
- $request : Request
- $requestType : int
- $e : Throwable
Return values
mixed —allowCustomResponseCode()
Mark the event as allowing a custom response code.
public
allowCustomResponseCode() : void
Return values
void —getKernel()
Returns the kernel in which this event was thrown.
public
getKernel() : HttpKernelInterface
Return values
HttpKernelInterface —getRequest()
Returns the request the kernel is currently processing.
public
getRequest() : Request
Return values
Request —getRequestType()
Returns the request type the kernel is currently processing.
public
getRequestType() : int
Return values
int —One of HttpKernelInterface::MAIN_REQUEST and HttpKernelInterface::SUB_REQUEST
getResponse()
Returns the response object.
public
getResponse() : Response|null
Return values
Response|null —getThrowable()
public
getThrowable() : Throwable
Return values
Throwable —hasResponse()
Returns whether a response was set.
public
hasResponse() : bool
Return values
bool —isAllowingCustomResponseCode()
Returns true if the event allows a custom response code.
public
isAllowingCustomResponseCode() : bool
Return values
bool —isMainRequest()
Checks if this is the main request.
public
isMainRequest() : bool
Return values
bool —isMasterRequest()
Checks if this is a master request.
public
isMasterRequest() : bool
Tags
Return values
bool —isPropagationStopped()
Is propagation stopped?
public
isPropagationStopped() : bool
Return values
bool —setResponse()
Sets a response and stops event propagation.
public
setResponse(Response $response) : mixed
Parameters
- $response : Response
Return values
mixed —setThrowable()
Replaces the thrown exception.
public
setThrowable(Throwable $exception) : void
This exception will be thrown if no response is set in the event.
Parameters
- $exception : Throwable
Return values
void —stopPropagation()
Stops the propagation of the event to further event listeners.
public
stopPropagation() : void
If multiple event listeners are connected to the same event, no further event listener will be triggered once any trigger calls stopPropagation().