Edit Report a Bug

    Exception

    (PHP 5, PHP 7, PHP 8)

    Introduction

    Exception is the base class for all user exceptions.

    Class synopsis

    class Exception implements Throwable {
    /* Properties */
    protected string $message = "";
    private string $string = "";
    protected int $code;
    protected string $file = "";
    protected int $line;
    private array $trace = [];
    private ?Throwable $previous = null;
    /* Methods */
    public __construct(string $message = "", int $code = 0, ?Throwable $previous = null)
    final public getMessage(): string
    final public getPrevious(): ?Throwable
    final public getCode(): int
    final public getFile(): string
    final public getLine(): int
    final public getTrace(): array
    final public getTraceAsString(): string
    public __toString(): string
    private __clone(): void
    }

    Properties

    message

    The exception message

    code

    The exception code

    file

    The filename where the exception was created

    line

    The line where the exception was created

    previous

    The previously thrown exception

    string

    The string representation of the stack trace

    trace

    The stack trace as an array

    Table of Contents

    add a note add a note

    User Contributed Notes 3 notes

    up
    93
    whysteepy at gmail dot com
    6 years ago
    Lists of Throwable and Exception tree as of 7.2.0

        Error
          ArithmeticError
            DivisionByZeroError
          AssertionError
          ParseError
          TypeError
            ArgumentCountError
        Exception
          ClosedGeneratorException
          DOMException
          ErrorException
          IntlException
          LogicException
            BadFunctionCallException
              BadMethodCallException
            DomainException
            InvalidArgumentException
            LengthException
            OutOfRangeException
          PharException
          ReflectionException
          RuntimeException
            OutOfBoundsException
            OverflowException
            PDOException
            RangeException
            UnderflowException
            UnexpectedValueException
          SodiumException

    Find the script and output in the following links:
    https://gist.github.com/mlocati/249f07b074a0de339d4d1ca980848e6a
    https://3v4l.org/sDMsv

    posted by someone here http://php.net/manual/en/class.throwable.php
    up
    35
    cHao
    10 years ago
    Note that an exception's properties are populated when the exception is *created*, not when it is thrown.  Throwing the exception does not seem to modify them.

    Among other things, this means:

    * The exception will blame the line that created it, not the line that threw it.

    * Unlike in some other languages, rethrowing an exception doesn't muck up the trace.

    * A thrown exception and an unthrown one look basically identical.  On my machine, the only visible difference is that a thrown exception has an `xdebug_message` property while an unthrown one doesn't.  Of course, if you don't have xdebug installed, you won't even get that.
    up
    3
    shaman_master at list dot ru
    4 years ago
    Note: this documentation not full, ReflectionObject::export($exception):
    <?php
    Object of     class [  class Exception implements Throwable ] {
      -     Properties [7] {
            Property [  protected $message ]
            Property [  private $string ]
            Property [  protected $code ]
            Property [  protected $file ]
            Property [  protected $line ]
            Property [  private $trace ]
            Property [  private $previous ]
      }
      -     Methods [11] {
            Method [  final private method __clone ] {
        }

            Method [  public method __construct ] {

          -     Parameters [3] {
                Parameter #0 [  $message ]
                Parameter #1 [  $code ]
                Parameter #2 [  $previous ]
              }
        }

            Method [  public method __wakeup ] {
        }

            Method [  final public method getMessage ] {
        }

            Method [  final public method getCode ] {
        }

            Method [  final public method getFile ] {
        }

            Method [  final public method getLine ] {
        }

            Method [  final public method getTrace ] {
        }

            Method [  final public method getPrevious ] {
        }

            Method [  final public method getTraceAsString ] {
        }

            Method [  public method __toString ] {
        }
      }
    }
    ?>

    Missed:

        Property [  private $string ]
        Property [  private $trace ]
        Property [  private $previous ]

        Method [  public method __wakeup ] {
        }
    add a note add a note
    To Top