资讯专栏INFORMATION COLUMN

PHP 完善的 Error / Exception 的捕获与处理

elliott_hu / 1830人阅读

摘要:有自身的错误捕获级别,默认,且不受设定的级别的影响。捕获错误异常捕获异常捕获类型错误返回值参数类型不正确严格模式下更容易出现捕获解析错误语法错误除无法捕获但除取余可以捕获很无奈基本错误这里要注意的是,在中依然无法隐式的完美捕获。

PHP(PHP_VERSION >= 7) 的 Error / Exception 的捕获与处理还是值得一说的,优雅处理错误与异常,在提升框架友好度的同时,也提升了开发效率。

PHP 错误等级

</>复制代码

  1. # 系统级用户代码的一些错误类型 可由 try ... catch ... 捕获
  2. E_PARSE 解析时错误 语法解析错误 少个分号 多个逗号一类的 致命错误
  3. E_ERROR 运行时错误 比如调用了未定义的函数或方法 致命错误
  4. # 系统级用户代码的一些错误类型 可由 set_error_handler 捕获处理
  5. E_WARNING 运行时警告 调用了未定义的变量
  6. E_NOTICE 运行时提醒
  7. E_DEPRECATED 运行时已废弃的函数或方法
  8. # 用户级自定义错误 可由 trigger_error 触发 可由 set_error_handler 捕获处理
  9. E_USER_ERROR 用户自定义错误 致命错误 未处理也会导致程序退出
  10. E_USER_WARNING
  11. E_USER_NOTICE
  12. E_USER_DEPRECATED
  13. ==========================开发中常遇到/不常遇到分割线=======================
  14. # Zend Engine 内部的一些错误 应该也能通过 try ... catch ... 捕获 略难测试
  15. E_CORE_ERROR
  16. E_CORE_WARNING
  17. E_COMPILE_ERROR
  18. E_COMPILE_WARNING
  19. #编码标准化警告(建议如何修改以向前兼容)
  20. E_STRICT 部分 try ... catch ... 部分 set_error_handler
  21. E_RECOVERABLE_ERROR

以上为 PHP 的一些错误监听级别,常用于 error_reporting 和 set_error_handler 的监听级别设定。

</>复制代码

  1. PHP 的错误处理其实可以分为:用户自定义错误处理PHP标准错误处理,两者的关系相当于两层错误捕捉器,系统会先检测是否定义了 用户自定义错误处理,否则会将错误交由 PHP标准错误处理 进行处理。

  2. 注意:PHP 的所有的 Exception 都属于 E_ERROR 级的错误,抛出时如果没有被捕获而交由 PHP 标准错误处理的话,就会 Fatal Error 导致程序退出执行。当然,PHP7 为了细化错误级别,划分了 ErrorError 的衍生类,这些也都属于 E_ERROR 级别的错误。

  3. PHP 标准错误处理
  4. PHP 标准错误处理是在一些错误没有被用户捕获处理(没有被 try ... catch ... 或 set_error_handler 捕获处理)时,错误 会递交至 PHP 标准错误处理。相关的设置项如下:

  5. </>复制代码

    1. 1、error_reporting([level])
    2. 获取或设定当前错误的监听级别。要注意,是获取或设定的 PHP 标准错误处理 的级别,不会有效于 try...catch... 或 set_error_handler。

    3. 2、display_errors
    4. 是否将错误信息回显至标准输出。默认开启,生产环境下强烈建议 关闭 此项。

    5. 3、log_errors
    6. 是否记录错误日志。默认关闭,生产环境下强烈建议 开启 此项。

    7. 4、error_log
    8. 错误日志的保存文件。注意:如果路径无效,display_errors 会被强制开启。

    9. PHP 用户自定义错误处理
    10. 1、set_error_handler
    11. set_error_handler 并非可以捕获所有错误,且 set_error_handler 不会终止程序继续执行。处理后若返回 false,则错误会被继续递交给 PHP 标准错误处理 流程。

    12. 可以捕获: E_WARNING & E_NOTICE & E_DEPRCATED & E_USER_* & 部分 E_STRICT 级的错误。
      无法捕获: E_ERROR & E_PARSE & E_CORE_* & E_COMPLIE_* 级的错误。

    13. 有自身的错误捕获级别,默认E_ALL | E_STRICT,且不受 error_reporting 设定的级别的影响。这里要理解,用户自定义错误处理 和 PHP 标准错误处理 是两层错误捕捉器,有独立的捕获级别。

    14. </>复制代码

      1. 2、trigger_error
      2. trigger_error 用来触发用户级别的自定义错误,可以使用 set_error_handler 捕获处理。
        默认的错误级别是 E_USER_NOTICE,我们可以自定义。
        这里需要注意的是:E_USER_ERROR 级别的错误如果被 PHP 标准错误处理 捕获,脚本也会退出执行错误。

      3. </>复制代码

        1. 3、set_exception_handler
        2. set_exception_handler 用户自定义捕获异常 handler,异常没有被 try ... catch 捕获处理的话会被抛出,此时系统会检查上下文是否注册了 set_exception_handler。
          如果未注册 则进入 PHP 标准错误处理 致命错误退出执行。
          如果已注册 则进入 set_exception_handler 处理 程序依然会退出执行。
          try ... catch ... 捕获异常后仍不会退出执行,故强烈建议将有异常的执行逻辑放入 try ... catch

        3. </>复制代码

          1. 4try ... catch ...
          2. 开发中用户层面的 set_error_hanlder 无法捕获的错误还剩下 E_ERRORE_PARSE 两个级别,使用 try ... catch ... 则可以将这俩货捕捉到。

          3. </>复制代码

            1. 来个小插曲:大家对 E_PARSE 熟悉又陌生,可能经常遇到(各大框架都有此级别错误捕获提示),但自己不知道如何捕获,其实首先要理解 E_PARSE 错误的发生时段。

            2. E_PARSE:即语法解析错误,Syntax Error then Parse Error,PHP 将脚本载入 Zend Engine 后,最开始要做的就是检查基本语法是否有误,无误才会调用解释器,一行行的开始解释运行。

            3. 这里就有个鸡生蛋,蛋生鸡的问题了。如下代码:

            4. </>复制代码

              1. 然后很多人会诧异,明明关闭了错误提示,为什么还会报错?

              2. 没错,代码的确正确的书写了关闭错误提示的意图。但还没被执行到时,脚本就因为最初始的语法解析错误,被 Zend Engine 抛出 Parse Error 终止执行了。同时还要理解,PHP include / require 只有在真的解释到这一行代码时,引用的文件才会被载入--解析--解释执行。

              3. 所以,我们需要有一个无错的 try ... catch ... 容器,在容器中便可以对后续引用的外部脚本进行 E_PARSE 错误捕捉。

              4. 例如框架自身是一个无错的运行容器,开发者自写的 MVC 是被 include / require 到此容器中 解析 -- 解释执行 的,用户代码的语法错误即会被容器的 try ... catch ... 优雅的捕获到。

            5. try ... catch ... 的错误捕获级别同样不受 error_reporting 影响,我们可以通过 多层 catch 细化各类型的错误。

            6. </>复制代码

              1. 这里要注意的是,DivisionByZeroError 在 PHP7 中依然无法隐式的完美捕获。准确的说:

              2. </>复制代码

                1. 当 x / 0 时抛出一个 E_WARNING 级别的错误,我们可以 set_error_handler 捕获,然后再判断错误为
                  "Devision by zero" 时抛出一个 ErrorException 的异常交由 try ... catch ... 捕获处理即可。

                  当 x % 0 时才会直接抛出 DivisionByZeroError 的错误。
                  或者使用 intdiv(x, 0) 来代替 x / 0,会自动抛出 DivisionByZeroError

              3. 当然,你也可以显示的判断除数为 0 来决定是否抛出个 DivisionByZeroError

              4. </>复制代码

                1. PHP 预定义的 Error 和 Exception
                2. Predefined Exceptions 预定义异常 可由系统自动抛出
                  http://php.net/manual/en/rese...

                3. </>复制代码

                  1. Exception
                    ErrorException
                    Error
                    ArgumentCountError
                    ArithmeticError
                    AssertionError
                    DivisionByZeroError
                    ParseError
                    TypeError
                4. SPL Exceptions SPL 标准规范异常 可供开发者规范代码自行抛出
                  http://php.net/manual/en/spl....

                5. </>复制代码

                  1. BadFunctionCallException
                    BadMethodCallException
                    DomainException
                    InvalidArgumentException
                    LengthException
                    LogicException
                    OutOfBoundsException
                    OutOfRangeException
                    OverflowException
                    RangeException
                    RuntimeException
                    UnderflowException
                    UnexpectedValueException
                6. 完善的错误和异常捕获
                7. 下面的代码基本呈现和捕获了 PHP7 提供的所有预定义错误和异常 及 PHP 标准错误处理
                  1、使用 try ... catch 捕获 E_ERROR 及 E_PARSE 级别的 Error (及Error 类的衍生类) 和 Exception (ErrorException)。
                  2、对于 try ... catch 无法捕获的 E_WARNING,E_NOTICE,E_DEPRECATED,E_USER_*,部分 E_STRICTED 级别的错误,我们使用 set_error_handler 捕获处理,捕获后我们其实可以将错误信息封装到 ErrorException 中并抛出,这样处理流又会交给 try ... catch,可以统一处理,比如Yii2框架就是这样处理的。
                  3、set_exception_handler 则是捕获在没有 try ... catch 中执行的代码的异常,所以强烈建议一些存在异常 风险的逻辑要放入 try ... catch 中。

                8. </>复制代码

                  1. = 7
                  2. // PHP 标准错误处理 捕获级别
                  3. error_reporting(E_ALL);
                  4. // 是否将 标准错误处理 捕获的错误回显在 stdout 上
                  5. ini_set("display_errors", false);
                  6. // 开启错误日志
                  7. ini_set("log_errors", true);
                  8. // 如果错误日志路径无效 display_errors 依然会强制打开
                  9. ini_set("error_log", __DIR__ . "/php-errors.log");
                  10. /**
                  11. * set_error_handler 用户自定义错误 handler
                  12. * 能够捕获 E_WARNING E_NOTICE E_DEPRECATED E_USER_* E_STRICT 级的错误
                  13. * 无法捕获 E_ERROR E_PARSE E_CORE_* E_COMPILE_* [DivisionByZeroError TypeError] 级的错误
                  14. */
                  15. set_error_handler(function ($error_no, $error_msg, $error_file, $error_line) {
                  16. switch ($error_no) {
                  17. case E_WARNING:
                  18. // x / 0 错误 PHP7 依然不能很友好的自动捕获 只会产生 E_WARNING 级的错误
                  19. // 捕获判断后 throw new DivisionByZeroError($error_msg)
                  20. // 或者使用 intdiv(x, 0) 方法 会自动抛出 DivisionByZeroError 的错误
                  21. if (strcmp("Division by zero", $error_msg) == 0) {
                  22. throw new DivisionByZeroError($error_msg);
                  23. }
                  24. $level_tips = "PHP Warning: ";
                  25. break;
                  26. case E_NOTICE:
                  27. $level_tips = "PHP Notice: ";
                  28. break;
                  29. case E_DEPRECATED:
                  30. $level_tips = "PHP Deprecated: ";
                  31. break;
                  32. case E_USER_ERROR:
                  33. $level_tips = "User Error: ";
                  34. break;
                  35. case E_USER_WARNING:
                  36. $level_tips = "User Warning: ";
                  37. break;
                  38. case E_USER_NOTICE:
                  39. $level_tips = "User Notice: ";
                  40. break;
                  41. case E_USER_DEPRECATED:
                  42. $level_tips = "User Deprecated: ";
                  43. break;
                  44. case E_STRICT:
                  45. $level_tips = "PHP Strict: ";
                  46. break;
                  47. default:
                  48. $level_tips = "Unkonw Type Error: ";
                  49. break;
                  50. }
                  51. // do some handle
                  52. $error = $level_tips . $error_msg . " in " . $error_file . " on " . $error_line;
                  53. echo $error . PHP_EOL;
                  54. // or throw a ErrorException back to try ... catch block
                  55. // throw new ErrorException($error);
                  56. // 如果 return false 则错误会继续递交给 PHP 标准错误处理
                  57. // return false;
                  58. }, E_ALL | E_STRICT);
                  59. /**
                  60. * set_exception_handler 用户自定义捕获异常 handler
                  61. * 异常没有被 try ... catch ... 捕获处理的话会被抛出
                  62. * 此时系统会检查上下文是否注册了 set_exception_handler
                  63. * 如果未注册 则进入 PHP 标准异常处理 致命错误退出执行
                  64. * 如果已注册 则进入 set_exception_handler 处理 程序依然会退出执行
                  65. * 而 try ... catch ... 捕获异常后仍不会退出执行
                  66. * 故强烈建议将有异常的执行逻辑放入 try ... catch
                  67. */
                  68. set_exception_handler(function ($exception) {
                  69. echo $exception;
                  70. // 此处程序会退出执行 异常到此结束 并不会交给 PHP 标准异常处理
                  71. });
                  72. // type error demo
                  73. function foo(int $bar): int
                  74. {
                  75. return "result type error";
                  76. }
                  77. // 捕获 E_ERROR E_PARSE 级的 Error
                  78. // 捕获 Exception
                  79. try {
                  80. // 加载外部文件的正确写法
                  81. $file = __DIR__ . "/bar.inc.php";
                  82. if (file_exists($file)) {
                  83. require_once $file;
                  84. } else {
                  85. throw new Exception($file . " not exists!");
                  86. }
                  87. // ParseError 解析错误
                  88. // bar.inc.php 的内容要有基本的语法错误: = 7.1.0
                  89. // strlen 参数错误
                  90. echo strlen("hello world", 4);
                  91. // TypeError 类型错误
                  92. // foo 要求的参数为整形,传递了字符串
                  93. // 返回类型为 intreturn 了 string 类型错误
                  94. foo("type error");
                  95. // DivisionByZeroError extends ArithmeticError
                  96. // x / 0 会抛出 E_WARNING 的异常 但不会自动抛出 DivisionByZeroError
                  97. // 我们可以使用 set_error_handler 进行捕获然后手动抛出 DivisionByZeroError
                  98. 1 / 0;
                  99. // Integer Divison 等同于 1 / 0 可以直接抛出 DivisionByZeroError
                  100. intdiv(1, 0);
                  101. // 除 0 取余 可以直接抛出 DivisionByZeroError
                  102. 1 % 0;
                  103. // ArithmeticError 错误
                  104. intdiv(PHP_INT_MIN, -1);
                  105. // AssertionError 断言错误
                  106. assert("1 != 1");
                  107. // 调用未定义的函数 错误级别:E_ERROR
                  108. bar();
                  109. } catch (ErrorException $errorException) {
                  110. // 错误异常
                  111. // 最常用的就是将那几个非致命的错误捕获后 ErrorException 回抛到 try ... catch
                  112. echo "ErrorException: " . $errorException . PHP_EOL;
                  113. } catch (Exception $exception) {
                  114. // 基本异常
                  115. echo "Exception: " . $exception . PHP_EOL;
                  116. } catch (ParseError $parseError) {
                  117. // 解析错误 语法错误
                  118. echo "Parse Error: " . $parseError . PHP_EOL;
                  119. } catch (ArgumentCountError $argumentCountError ) {
                  120. // 传参非法错误 php >= 7.1.0
                  121. echo "Argument Count Error: " . $argumentCountError . PHP_EOL;
                  122. } catch (TypeError $typeError) {
                  123. // 类型错误 返回值
                  124. echo "Type Error: " . $typeError . PHP_EOL;
                  125. } catch (DivisionByZeroError $divisionByZeroError) {
                  126. // x / 0 不抛出 x % 0 可以抛出
                  127. // x / 0 可以用 intdiv(x, 0) 代替 会抛出
                  128. echo "Division By Zero Error: " . $divisionByZeroError . PHP_EOL;
                  129. } catch (ArithmeticError $arithmeticError) {
                  130. // 算数运算错误 intdiv(PHP_INT_MIN, -1) 触发
                  131. echo "Arithmetic Error: " . $arithmeticError . PHP_EOL;
                  132. } catch (AssertionError $assertionError) {
                  133. // 断言错误
                  134. echo "Assertion Error: " . $assertionError . PHP_EOL;
                  135. } catch (Error $error) {
                  136. // 基本错误
                  137. echo "Error: " . $error . PHP_EOL;
                  138. }
                  139. echo "run finished!" . PHP_EOL;
                9. 总结
                10. 1、PHP 允许用户自定义 Error 和 Exception 的捕获与处理。如用户未捕获处理,则会递交给 PHP 标准错/异常处理,根据 errror_reporting display_errors log_erros error_log 参数决定处理方式。生产环境应关闭 display_errors 同时开启 log_errors 记录错误日志。

                11. 2、set_error_handler 可以捕获 E_WARNING & E_NOTICE & E_DEPRECATED & E_USER_* 和 部分 E_STRICT 级的错误。set_error_handler 如果返回了 false 错误会递交给 PHP 标准错误处理。set_error_handler 不会终止程序执行。

                12. 3、trigger_error 可以用来抛出用户级的错误,且 E_USER_ERROR 效用等同于 E_ERROR,PHP 标准错误处理 捕获此级别的错误时会终止程序执行。

                13. 4、set_exception_handler 用户自定义异常捕获,捕获后程序依然会终止运行,但不会再将异常递交给 PHP 标准异常处理。

                14. 5try ... catch 可以捕获所有的 Exception 和 E_ERROR & E_PARSE 级的错误。程序不会退出执行。

                15. 6、PHP 自带了一些 Predefined Exceptions,同时有规范一些 SPL Exceptions,供开发者规范自己的错误异常架构。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/30816.html

相关文章

  • PHP 错误异常

    摘要:但异常捕获后程序可以继续执行,而真正的错误出现后程序就必须终止异常可以使用来捕获捕获,捕获之后后续代码可以继续执行而错误是无法使用捕获的如果抛出了异常,就必须捕获它否则程序终止执行。 PHP错误级别 Parse error > Fatal Error > Waning > Notice > Deprecated Deprecated 最低级别的错误(不推荐,不建议)使用一些过期函数的...

    longmon 评论0 收藏0
  • PHP异步尝试一:初识生成器

    摘要:下的异步尝试系列下的异步尝试一初识生成器下的异步尝试二初识协程下的异步尝试三协程的版自动执行器下的异步尝试四版的下的异步尝试五版的的继续完善生成器类获取迭代器当前值获取迭代器当前值返回当前产生的键生成器从上一次处继续执行重置迭代器向生成器中 PHP下的异步尝试系列 PHP下的异步尝试一:初识生成器 PHP下的异步尝试二:初识协程 PHP下的异步尝试三:协程的PHP版thunkify自...

    tomorrowwu 评论0 收藏0
  • PHP超实用系列·自动捕获Fatal Error

    摘要:重要使命经过十几天的忙碌,张小五手上的项目终于如期上线,虽然很累,但内心无比的充实与喜悦。对,是不好捕获。从到对于码农来说,从到是解决问题的通途,当然张小五也不例外。 重要使命 经过十几天的忙碌,张小五手上的项目终于如期上线,虽然很累,但内心无比的充实与喜悦。喝了杯热咖啡,小五在椅子上慵懒地躺着,享受着这份静谧的时光。 嗨,小五,这几天累坏了吧?哈哈,是有点累,不过还好。 周末好好休息...

    alphahans 评论0 收藏0
  • Laravel核心解读--异常处理

    摘要:请求未通过的验证时会抛出此异常。异常处理是非常重要但又容易让开发者忽略的功能,这篇文章简单解释了内部异常处理的机制以及扩展异常处理的方式方法。 异常处理是编程中十分重要但也最容易被人忽视的语言特性,它为开发者提供了处理程序运行时错误的机制,对于程序设计来说正确的异常处理能够防止泄露程序自身细节给用户,给开发者提供完整的错误回溯堆栈,同时也能提高程序的健壮性。 这篇文章我们来简单梳理一下...

    includecmath 评论0 收藏0
  • PHP框架中日志系统

    摘要:一的几个函数异常捕获自定义处理函数注册错误捕获自定义处理函数注册程序执行时异常终止错误捕获处理函数注册这三个函数在错误处理控制中给开发者提供了很大的自主空间,在日志系统中记录日志信息有他们的功劳。下面要说的类库是借鉴了日志系统的设计。 引言 接触过php框架的朋友们可能都知道,日志在项目中的重要作用了,他可以帮助我们定位错误的位置,让程序更友好(处理得当的话不会直接抛出一大堆只有程...

    ningwang 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<