Exception::__toString

(PHP 5, PHP 7, PHP 8)

Exception::__toString — String representation of the exception

Description

public Exception::__toString(): string

Returns the string representation of the exception.

Parameters

This function has no parameters.

Return Values

Returns the string representation of the exception.

Examples

Example #1 Exception::__toString() example

<?php
try {
    throw new Exception("Some error message");
} catch(Exception $e) {
    echo $e;
}
?>

The above example will output something similar to:

exception 'Exception' with message 'Some error message' in /home/bjori/tmp/ex.php:3
Stack trace:
#0 {main}

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

devnull ¶

3 months ago

The Exception __toString implementation will also include the string representation of previous exceptions chained to this exception, _before_ the string representation of the current exception.

For example:

<?php
class OuterException extends Exception {}
class MiddleException extends Exception {}
class InnerException extends Exception {}

$excA = new InnerException("inner exception", 0);
$excB = new MiddleException("middle exception", 0, $excA);
$excC = new OuterException("outer exception", 0, $excB);

echo "The exception is:\n$excC";
?>

will print the following:

The exception is:
InnerException: inner exception in test.php:6
Stack trace:
#0 {main}

Next MiddleException: middle exception in test.php:7
Stack trace:
#0 {main}

Next OuterException: outer exception in test.php:8
Stack trace:
#0 {main}