PHP 中的错误有如下这些类型(这个表格的内容取自 PHP 文档):
值 | 常量 | 说明 | 备注 |
1 | E_ERROR | 致命的运行时错误。这类错误一般是不可恢复的情况,例如内存分配导致的问题。后果是导致脚本终止不再继续运行。 | |
2 | E_WARNING | 运行时警告 (非致命错误)。仅给出提示信息,但是脚本不会终止运行。 | |
4 | E_PARSE | 编译时语法解析错误。解析错误仅仅由分析器产生。 | |
8 | E_NOTICE | 运行时通知。表示脚本遇到可能会表现为错误的情况,但是在可以正常运行的脚本里面也可能会有类似的通知。 | |
16 | E_CORE_ERROR | 在 PHP 初始化启动过程中发生的致命错误。该错误类似 E_ERROR,但是是由 PHP 引擎核心产生的。 | since PHP 4 |
32 | E_CORE_WARNING | PHP 初始化启动过程中发生的警告 (非致命错误) 。类似 E_WARNING,但是是由 PHP 引擎核心产生的。 | since PHP 4 |
64 | E_COMPILE_ERROR | 致命编译时错误。类似 E_ERROR,但是是由 Zend 脚本引擎产生的。 | since PHP 4 |
128 | E_COMPILE_WARNING | 编译时警告 (非致命错误)。类似 E_WARNING,但是是由 Zend 脚本引擎产生的。 | since PHP 4 |
256 | E_USER_ERROR | 用户产生的错误信息。类似 E_ERROR,但是是由用户自己在代码中使用 PH P函数 trigger_error() 来产生的。 | since PHP 4 |
512 | E_USER_WARNING | 用户产生的警告信息。类似 E_WARNING,但是是由用户自己在代码中使用PHP函数 trigger_error() 来产生的。 | since PHP 4 |
1024 | E_USER_NOTICE | 用户产生的通知信息。类似 E_NOTICE,但是是由用户自己在代码中使用 PHP 函数 trigger_error() 来产生的。 | since PHP 4 |
2048 | E_STRICT | 启用 PHP 对代码的修改建议,以确保代码具有最佳的互操作性和向前兼容性。 | since PHP 5 |
4096 | E_RECOVERABLE_ERROR | 可被捕捉的致命错误。 它表示发生了一个可能非常危险的错误,但是还没有导致 PHP 引擎处于不稳定的状态。 如果该错误没有被用户自定义句柄捕获 (参见 set_error_handler()),将成为一个 E_ERROR,从而脚本会终止运行。 | since PHP 5.2.0 |
8192 | E_DEPRECATED | 运行时通知。启用后将会对在未来版本中可能无法正常工作的代码给出警告。 | since PHP 5.3.0 |
16384 | E_USER_DEPRECATED | 用户产少的警告信息。 类似 E_DEPRECATED,但是是由用户自己在代码中使用 PHP 函数 trigger_error() 来产生的。 | since PHP 5.3.0 |
30719 | E_ALL | E_STRICT 除外的所有错误和警告信息。 | 30719 in PHP 5.3.x, 6143 in PHP 5.2.x, 2047 previously |
几种常见错误的具体例子如下:
错误类型 | 实际例子 | 错误消息 |
E_ERROR | 调用不存在的函数,例如没启用 mysql 扩展就使用 mysql_connect | Fatal error: Call to undefined function mysql_connect() |
E_WARNING | 包含不存在的 PHP 文件,例如 include "none.php"; | Warning: include(none.php): failed to open stream: No such file or directory |
除以零,例如 echo 3 / 0; | Warning: Division by zero | |
E_PARSE | 语句的结尾没用分号 | Parse error: syntax error, unexpected T_VARIABLE, expecting ',' or ';' |
E_NOTICE | 使用未定义的变量,例如 echo $noexist; | Notice: Undefined variable: noexist |
使用未定义的数组元素,例如 echo $_GET["option"]; | Notice: Undefined index: option |
在 PHP 的配置文件 php.ini 中我们可以设置如何记录错误(也可以在 PHP 脚本中用 ini_set 函数来设置)。例如:
选项 | 默认值 | 开发环境 | 生产环境 |
error_reporting | E_ALL & ~E_NOTICE | E_ALL | E_STRICT | E_ALL & ~E_DEPRECATED |
display_errors | On | On | Off |
display_startup_errors | Off | On | Off |
log_errors | Off | On | On |
error_log | NULL | "php_error.log" | "php_error.log" |
也就是说,在开发环境中我们一般让 PHP 报告并显示所有错误,而在生产环境中我们让 PHP 报告大部分错误但不显示它们。而且我们需要将各种错误都记录在日志文件中。
我们也可以用 set_error_handler 函数来自己处理错误。例如:
function myErrorHandler($errno, $errstr, $errfile, $errline) { if (!(error_reporting() & $errno)) { // 仅处理 error_reporting() 中包含的错误 return; } switch ($errno) { case E_USER_ERROR: echo "error: $errstr<br />\n"; echo "error: on line $errline in file $errfile<br />\n"; exit(1); break; case E_USER_WARNING: case E_WARNING: echo "warning: $errstr<br />\n"; break; case E_USER_NOTICE: case E_NOTICE: echo "notice: $errstr<br />\n"; break; default: echo "unknown error: [$errno] $errstr<br />\n"; break; } // 返回 true 则不再进行 PHP 内部的错误处理 return true; } set_error_handler("myErrorHandler");
set_error_handler 函数不能处理导致 PHP 脚本无法运行的错误,例如 E_ERROR,E_PARSE 和大部分 E_STRICT 错误。对于这种情形,我们可以参考 register_shutdown_function 函数。另外,对于用 @ 运算符屏蔽的错误,可以通过 error_reporting() 函数的返回值为 0 来判断。
实际上,用 set_error_handler 函数,还是不如将所有错误都记录到日志中,然后查看日志更加方便。
类似地,对于用户定义的异常,有 set_exception_handler 函数可以处理。
参考资料:
[1] PHP: Predefined Constants - Manual
[2] PHP: Runtime Configuration - Manual
[3] PHP: error_reporting - Manual
[4] PHP: set_error_handler - Manual
[5] PHP: Error Control Operators - Manual
[6] PHP: register_shutdown_function - Manual
[7] PHP: set_exception_handler - Manual
[8] Reference - What does this error mean in PHP? - Stack Overflow
[9] PHP用set_error_handler()拦截程序中的错误