PHP 中内置了哪些异常子类？

Question

我还没有找到 PHP 中所有内置 Exception 子类的列表。在创建我自己的异常子类之前，我宁愿在有意义的时候使用内置的。

例如，我知道 InvalidArgumentException 存在，但似乎没有任何东西可以与 Java 的 NullPointerException 相比。

是否有人拥有或可以链接到 PHP 中可用的异常子类列表？

Answer 1

PHP 5 有两个内置异常

• Exception
• ErrorException

PHP 中的库有自己的内置异常

• DOMException DOM 操作在特定情况下会引发异常，例如，当操作因逻辑原因无法执行时。
• IntlException 他的类用于在 intl 函数内部发生错误时生成异常。此类异常仅在启用 intl.use_exceptions 时生成。
• PharException 使用 Phar 类时抛出
• ReflectionException 使用反射类时抛出

SPL includes a few of its own built in exceptions:

• BadFunctionCallException 回调指的是未定义的函数或缺少某些参数。
• BadMethodCallException 回调指的是未定义的方法或缺少某些参数。
• DomainException 值不符合定义的有效数据域。
• InvalidArgumentException 传递的参数无效。
• LengthException参数超过了允许的长度（用于字符串、数组、文件大小等）。
• LogicException 程序逻辑出现一般错误。
• OutOfBoundsException 请求了非法索引。
• OutOfRangeException 请求了非法索引。这表示应在编译时检测到的错误。
• OverflowException 将元素添加到已满的容器中。
• RangeException 指示程序执行期间的范围错误。通常这意味着存在除下溢/溢出之外的算术错误。
• RuntimeException 出现只能在运行时发现的错误。
• UnderflowException 对空容器执行无效操作，例如移除元素。
• UnexpectedValueException 收到意外值（即作为方法调用返回值的结果）。

PHP 7 引入了新的异常，包括可捕获的错误。新的例外情况包括：

• Throwable 是 PHP 7 中可以通过 throw 语句抛出的任何对象的基本接口，包括错误和异常。
• Error 是所有 PHP 内部错误的基类。
• AssertionError 在通过 assert() 的断言失败时抛出。
• ParseError 在解析 PHP 代码时发生错误时抛出，例如调用 eval() 时。
• TypeError 在三种情况下可能会抛出 TypeError。第一个是传递给函数的参数类型与其对应的声明参数类型不匹配。第二个是从函数返回的值与声明的函数返回类型不匹配。第三个是将无效数量的参数传递给内置 PHP 函数（仅限严格模式）。
• ArithmeticError 在执行数学运算时发生错误时抛出。在 PHP 7.0 中，这些错误包括尝试执行负数移位，以及任何对 intdiv() 的调用都会导致值超出可能的整数范围。
• DivisionByZeroError 在尝试将数字除以零时抛出。
• 当传递给用户定义的函数或方法的参数太少时，会抛出 ArgumentCountError。

PHP 7.3 引入了 JSON 异常：

• 当json_encode() 和json_decode() 遇到错误时，会抛出JsonException。

PHP 8 引入了一个新异常：

• ValueError 在您将值传递给具有有效类型但不能用于操作的函数时抛出。

这是一个演示 PHP 7 中引入的新层次结构的图表：

\Throwable
├── \Exception (implements \Throwable)
|   |── \DOMException (extends \Exception)
|   ├── \IntlException (extends \Exception)
|   ├── \JsonException (extends \Exception)
|   |── \PharException (extends \Exception)
|   |── \ReflectionException (extends \Exception)
|   |── \ValueError (extends \Exception)
│   ├── \LogicException (extends \Exception)
│   │   ├── \BadFunctionCallException (extends \LogicException)
│   │   │   └── \BadMethodCallException (extends \BadFunctionCallException)
│   │   ├── \DomainException (extends \LogicException)
│   │   ├── \InvalidArgumentException (extends \LogicException)
│   │   ├── \LengthException (extends \LogicException)
│   │   └── \OutOfRangeException (extends \LogicException)
│   └── \RuntimeException (extends \Exception)
│       ├── \OutOfBoundsException (extends \RuntimeException)
│       ├── \OverflowException (extends \RuntimeException)
│       ├── \RangeException (extends \RuntimeException)
│       ├── \UnderflowException (extends \RuntimeException)
│       └── \UnexpectedValueException (extends \RuntimeException)
└── \Error (implements \Throwable)
    ├── \AssertionError (extends \Error)
    ├── \ParseError (extends \Error)
    └── \TypeError (extends \Error)
        └── \ArgumentCountError (extends \TypeError)
    └── \ArithmeticError (extends \Error)
        └── \DivisionByZeroError extends \ArithmeticError)

Answer 2

其实，现在我崩溃了，问了，我还是设法找到了他们。

从技术上讲，PHP 似乎只有 2 个内置异常： http://www.php.net/manual/en/reserved.exceptions.php

SPL 还定义了几个： http://www.php.net/manual/en/spl.exceptions.php

解释他们的层次结构： http://www.php.net/~helly/php/ext/spl/classException.html http://web.archive.org/web/20130829124146/http://www.php.net/~helly/php/ext/spl/classException.html（2013 年 8 月 29 日存档）

更新

上面的链接失效了，它是一个基本的 PHP 异常层次结构图。我找不到原件，但这里有一个替代品：

最初发现于http://fossies.org/dox/php-5.2.17/classException.html，现在存档于http://web.archive.org/web/20151002165210/https://fossies.org/dox/php-5.2.17/classException.html（存档于 2015 年 10 月 2 日）