PHP 错误

基础

PHP 遇到内部错误时会报告出来。

PHP 产生的每个错误都包含了类型,以下的错误类型清单附带了不同类型的简短描述和产生的原因。

错误类型清单
常量说明备注
1E_ERROR (int)致命的运行时错误。这类错误一般是不可恢复的情况,例如内存分配导致的问题,后果是导致脚本终止不再继续运行。
2E_WARNING (int)运行时警告 (非致命错误)。仅给出提示信息,但是脚本不会终止运行。
4E_PARSE (int)编译时语法解析错误。解析错误仅仅由分析器产生。
8E_NOTICE (int)运行时通知。表示脚本遇到可能会表现为错误的情况,但是在可以正常运行的脚本里面也可能会有类似的通知。
16E_CORE_ERROR (int)在 PHP 初始化启动过程中发生的致命错误。该错误类似 E_ERROR,但是是由 PHP 引擎核心产生的。
32E_CORE_WARNING (int)PHP 初始化启动过程中发生的警告 (非致命错误) 。类似 E_WARNING,但是是由 PHP 引擎核心产生的。
64E_COMPILE_ERROR (int)致命编译时错误。类似 E_ERROR,但是是由 Zend 脚本引擎产生的。
128E_COMPILE_WARNING (int)编译时警告 (非致命错误)。类似 E_WARNING,但是是由 Zend 脚本引擎产生的。
256E_USER_ERROR (int)用户产生的错误信息。类似 E_ERROR,但是是由用户自己在代码中使用 PHP 函数 trigger_error()来产生的。
512E_USER_WARNING (int)用户产生的警告信息。类似 E_WARNING,但是是由用户自己在代码中使用 PHP 函数 trigger_error()来产生的。
1024E_USER_NOTICE (int)用户产生的通知信息。类似 E_NOTICE,但是是由用户自己在代码中使用 PHP 函数 trigger_error()来产生的。 
2048E_STRICT (int)启用 PHP 对代码的修改建议,以确保代码具有最佳的互操作性和向前兼容性。PHP 5.4.0 之前的版本中不包含 E_ALL
4096E_RECOVERABLE_ERROR (int)可被捕捉的致命错误。 它表示发生了一个可能非常危险的错误,但是还没有导致PHP引擎处于不稳定的状态。 如果该错误没有被用户自定义句柄捕获 (参见 set_error_handler()),将成为一个 E_ERROR 从而脚本会终止运行。自 PHP 5.2.0 起
8192E_DEPRECATED (int)运行时通知。启用后将会对在未来版本中可能无法正常工作的代码给出警告。自 PHP 5.3.0 起
16384E_USER_DEPRECATED (int)用户产少的警告信息。 类似 E_DEPRECATED, 但是是由用户自己在代码中使用PHP函数 trigger_error()来产生的。自 PHP 5.3.0 起
32767E_ALL (int)PHP 5.4.0 之前为 E_STRICT 除外的所有错误和警告信息。PHP 5.4.x 中为 32767, PHP 5.3.x 中为 30719, PHP 5.2.x 中为 6143, 更早之前的 PHP 版本中为 2047。


PHP 错误处理

当未设置错误处理函数时,PHP 会根据配置处理所有出现的错误。 

可以通过 php.ini 中 error_reporting 的配置或者是运行时调用 error_reporting() 控制哪些错误需要报告,哪些错误需要自动忽略。 

由于有些错误会在运行用户脚本前就可能出现,所以强烈推荐用配置指令来设置。

在开发环境里为了发现并修复 PHP 产生的问题, 应该总是把 error_reporting 设置为 E_ALL。 

在生产环境里,用户可能为了降低信息的详细程度, 想要将它设置为类似 E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED, 但很多情况下 E_ALL 也同样适用,这样可以更早地警告潜在问题。

PHP 对这些错误的处理方式,取决于两个 php.ini 指令。 

display_errors 控制了是否要将错位作为脚本输出的一部分显示,在生产环境里应该禁用,因为可能包含类似数据库密码这样的敏感信息, 而在开发环境中应该启用,能确保立即报告问题。

PHP 不仅能显示错误,还可以开启 log_errors 指令来记录错误日志,它能根据 error_log 的设置, 记录任意错误到文件或者 syslog。 特别适用于生产环境,用户可以记录发生的错误,并根据这些错误生成报告。


自定义错误处理

如果 PHP 默认错误处理器还不能满足要求,用户可以通过 set_error_handler() 设置自定义错误处理器,可处理很多类型的错误。 虽然有些类型的错误不能通过这种方式处理,但能处理的类型可以用脚本合适的方式处理: 例如为用户显示自定义错误页面,同时以一种比日志更直接的方式上报错误,例如发送邮件。


PHP 7 错误处理

PHP 7 改变了大多数错误的报告方式,不同于传统(PHP 5)的错误报告机制,现在大多数错误被作为 Error 异常抛出。

这种 Error 异常可以像 Exception 异常一样被第一个匹配的 try / catch 块所捕获。如果没有匹配的 catch 块,则调用异常处理函数(事先通过 set_exception_handler() 注册)进行处理。 如果尚未注册异常处理函数,则按照传统方式处理:被报告为一个致命错误(Fatal Error)。

Error 类并非继承自 Exception 类,所以不能用 catch (Exception $e) { ... } 来捕获 Error。你可以用 catch (Error $e) { ... },或者通过注册异常处理函数( set_exception_handler())来捕获 Error。


Error 层次结构

Throwable

        Error

                ArithmeticError

                        DivisionByZeroError

                AssertionError

                CompileError

                        ParseError

                TypeError

                        ArgumentCountError

        Exception

                ......