class HandleExceptions (View source)

Properties

static string $reservedMemory

Reserved memory so that errors can be displayed properly on memory exhaustion.

static protected Application $app

The application instance.

Methods

void
bootstrap(Application $app)

Bootstrap the given application.

void
handleError(int $level, string $message, string $file = '', int $line = 0, array $context = [])

Report PHP deprecations, or convert PHP errors to ErrorException instances.

void
handleDeprecation(string $message, string $file, int $line)

Reports a deprecation to the "deprecations" logger.

void
ensureDeprecationLoggerIsConfigured()

Ensure the "deprecations" logger is configured.

void
ensureNullLogDriverIsConfigured()

Ensure the "null" log driver is configured.

void
handleException(Throwable $e)

Handle an uncaught exception from the application.

void
renderForConsole(Throwable $e)

Render an exception to the console.

void
renderHttpResponse(Throwable $e)

Render an exception as an HTTP response and send it.

void
handleShutdown()

Handle the PHP shutdown event.

FatalError
fatalErrorFromPhpError(array $error, int|null $traceOffset = null)

Create a new fatal error instance from an error array.

callable
forwardsTo($method)

Forward a method call to the given method if an application instance exists.

bool
isDeprecation(int $level)

Determine if the error level is a deprecation.

bool
isFatal(int $type)

Determine if the error type is fatal.

getExceptionHandler()

Get an instance of the exception handler.

static void
forgetApp()

Clear the local application instance from memory.

Details

void bootstrap(Application $app)

Bootstrap the given application.

Parameters

Application $app

Return Value

void

void handleError(int $level, string $message, string $file = '', int $line = 0, array $context = [])

Report PHP deprecations, or convert PHP errors to ErrorException instances.

Parameters

int $level
string $message
string $file
int $line
array $context

Return Value

void

Exceptions

ErrorException

void handleDeprecation(string $message, string $file, int $line)

Reports a deprecation to the "deprecations" logger.

Parameters

string $message
string $file
int $line

Return Value

void

protected void ensureDeprecationLoggerIsConfigured()

Ensure the "deprecations" logger is configured.

Return Value

void

protected void ensureNullLogDriverIsConfigured()

Ensure the "null" log driver is configured.

Return Value

void

void handleException(Throwable $e)

Handle an uncaught exception from the application.

Note: Most exceptions can be handled via the try / catch block in the HTTP and Console kernels. But, fatal error exceptions must be handled differently since they are not normal exceptions.

Parameters

Throwable $e

Return Value

void

protected void renderForConsole(Throwable $e)

Render an exception to the console.

Parameters

Throwable $e

Return Value

void

protected void renderHttpResponse(Throwable $e)

Render an exception as an HTTP response and send it.

Parameters

Throwable $e

Return Value

void

void handleShutdown()

Handle the PHP shutdown event.

Return Value

void

protected FatalError fatalErrorFromPhpError(array $error, int|null $traceOffset = null)

Create a new fatal error instance from an error array.

Parameters

array $error
int|null $traceOffset

Return Value

FatalError

protected callable forwardsTo($method)

Forward a method call to the given method if an application instance exists.

Parameters

$method

Return Value

callable

protected bool isDeprecation(int $level)

Determine if the error level is a deprecation.

Parameters

int $level

Return Value

bool

protected bool isFatal(int $type)

Determine if the error type is fatal.

Parameters

int $type

Return Value

bool

protected ExceptionHandler getExceptionHandler()

Get an instance of the exception handler.

Return Value

ExceptionHandler

static void forgetApp()

Clear the local application instance from memory.

Return Value

void