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