PHP的错误机制总结

PHP的错误机制也是非常复杂的,做了几年php,也没有仔细总结过,现在就补上这一课。

错误类型

因为错误类型整型值的巧妙设定,可以采用按位运算符

特别说明:文章的PHP版本使用5.5.32

1 E_ERROR

致命的运行时错误。这类错误一般是不可恢复的情况,例如内存分配导致的问题。
导致脚本终止不再继续运行
例子:调用一个未定义的函数,存在没有捕获的异常

PHP的错误级别

首先需要了解php有哪些错误。截至到php5.5,一共有16个错误级别

注意:尝试下面的代码的时候请确保打开error_log:

error_reporting(E_ALL);
ini_set('display_errors', 'On');

2 E_WARNING

运行时警告
仅给出提示信息,但是脚本不会终止运行。

E_ERROR

这种错误是致命错误,会在页面显示Fatal Error,
当出现这种错误的时候,程序就无法继续执行下去了

错误示例:

// Fatal error: Call to undefined function hpinfo() in /tmp/php/index.php on line 5
hpinfo();  //E_ERROR

注意,如果有未被捕获的异常,也是会触发这个级别的。

// Fatal error: Uncaught exception 'Exception' with message 'test exception' in /tmp/php/index.php:5 Stack trace: #0 {main} thrown in /tmp/php/index.php on line 5
throw new Exception("test exception");

4 E_PARSE

编译时语法解析错误。
解析错误仅仅由分析器产生。
register_shutdown_function不能捕获到本文件内发生的这个错误

E_WARNING

这种错误只是警告,不会终止脚本,程序还会继续进行,显示的错误信息是Warning。比如include一个不存在的文件。

//Warning: include(a.php): failed to open stream: No such file or directory in /tmp/php/index.php on line 7
//Warning: include(): Failed opening 'a.php' for inclusion (include_path='.:/usr/share/pear:/usr/share/php') in /tmp/php/index.php on line 7
include("a.php"); //E_WARNING

8 E_NOTICE

运行时通知。表示脚本遇到可能会表现为错误的情况,但是在可以正常运行的脚本里面也可能会有类似的通知
例子:使用未定义的变量

E_NOTICE

这种错误程度更为轻微一些,提示你这个地方不应该这么写。这个也是运行时错误,这个错误的代码可能在其他地方没有问题,只是在当前上下文情况下出现了问题。

比如$b变量不存在,我们把它赋值给另外一个变量

//Notice: Undefined variable: b in /tmp/php/index.php on line 9
$a = $b; //E_NOTICE

16 E_CORE_ERROR

在PHP初始化启动过程中发生的致命错误。
该错误类似 E_ERROR,但是是由PHP引擎核心产生的。

E_PARSE

这个错误是编译时候发生的,在编译期发现语法错误,不能进行语法分析。

比如下面的z没有设置为变量。

// Parse error: syntax error, unexpected '=' in /tmp/php/index.php on line 20
z=1; // E_PARSE

32 E_CORE_WARNING

PHP初始化启动过程中发生的警告
类似 E_WARNING,但是是由PHP引擎核心产生的

E_STRICT

这个错误是PHP5之后引入的,你的代码可以运行,但是不是PHP建议的写法。

比如在函数形参传递++符号

// Strict Standards: Only variables should be passed by reference in /tmp/php/index.php on line 17
function change (&$var) {
  $var += 10;
}

$var = 1;
change(++$var);
// E_STRICT

E_COMPILE_

编译相关
64 E_COMPILE_ERROR
致命编译时错误。类似E_ERROR, 但是是由Zend脚本引擎产生的。 since PHP 4
128 E_COMPILE_WARNING
编译时警告 。类似 E_WARNING,但是是由Zend脚本引擎产生的。

E_RECOVERABLE_ERROR

这个级别其实是ERROR级别的,但是它是期望被捕获的,如果没有被错误处理捕获,表现和E_ERROR是一样的。

经常出现在形参定义了类型,但调用的时候传入了错误类型。它的错误提醒也比E_ERROR的fatal
error前面多了一个Catachable的字样。

//Catchable fatal error: Argument 1 passed to testCall() must be an instance of A, instance of B given, called in /tmp/php/index.php on line 37 and defined in /tmp/php/index.php on line 33
class A {
}

class B {
}

function testCall(A $a) {
}

$b = new B();
testCall($b);

E_USER_

用户产生的
256 E_USER_ERROR
用户产生的错误信息。类似 E_ERROR, 但是是由用户自己在代码中使用PHP函数
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()来产生的

E_DEPRECATED

这个错误表示你用了一个旧版本的函数,而这个函数后期版本可能被禁用或者不维护了。

比如curl的CURLOPT_POSTFIELDS使用@FILENAME来上传文件的方法

// Deprecated: curl_setopt(): The usage of the @filename API for file uploading is deprecated. Please use the CURLFile class instead in /tmp/php/index.php on line 42
$ch = curl_init("http://www.remotesite.com/upload.php");
curl_setopt($ch, CURLOPT_POSTFIELDS, array('fileupload' => '@'. "test"));

2048 E_STRICT

启用 PHP 对代码的修改建议,以确保代码具有最佳的互操作性和向前兼容性。

E_CORE_ERROR, E_CORE_WARNING

这两个错误是由PHP的引擎产生的,在PHP初始化过程中发生。

4096 E_RECOVERABLE_ERROR

可被捕捉的致命错误。
它表示发生了一个可能非常危险的错误,但是还没有导致PHP引擎处于不稳定的状态。
如果该错误没有被用户自定义句柄捕获 ( set_error_handler,将成为一个
E_ERROR 从而脚本会终止运行。

E_COMPILE_ERROR, E_COMPILE_WARNING

这两个错误是由PHP引擎产生的,在编译过程中发生。

8192 E_DEPRECATED

运行时通知。
启用后将会对在未来版本中可能无法正常工作的代码给出警告。

E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED,

这些错误都是用户制造的,使用trigger_error,这里就相当于一个口子给用户触发出各种错误类型。这个是一个很好逃避try
catch异常的方式。

trigger_error("Cannot divide by zero", E_USER_ERROR);
// E_USER_ERROR
// E_USER_WARING
// E_USER_NOTICE
// E_USER_DEPRECATED

16384 E_USER_DEPRECATED

用户产生的警告信息。 类似 E_DEPRECATED,
但是是由用户自己在代码中使用PHP函数 trigger_error()来产生的。

E_ALL

E_STRICT出外的所有错误和警告信息。

30719 E_ALL

E_STRICT出外的所有错误和警告信

错误控制

php中有很多配置和参数是可以控制错误,以及错误的日志显示的。第一步,我们需要了解的是php中的有关错误的配置有哪些?

我们按照php+php-fpm的模型来说,会影响php错误显示的其实是有两个配置文件,一个是php本身的配置文件php.ini,另外一个是php-fpm的配置文件,php-fpm.conf。

错误处理相关函数

php.ini中的配置

error_reporting = E_ALL  // 报告错误级别,什么级别的
error_log = /tmp/php_errors.log // php中的错误显示的日志位置
display_errors = On // 是否把错误展示在输出上,这个输出可能是页面,也可能是stdout
display_startup_errors = On // 是否把启动过程的错误信息显示在页面上,记得上面说的有几个Core类型的错误是启动时候发生的,这个就是控制这些错误是否显示页面的。
log_errors = On // 是否要记录错误日志
log_errors_max_len = 1024 // 错误日志的最大长度
ignore_repeated_errors = Off // 是否忽略重复的错误
track_errors = Off // 是否使用全局变量$php_errormsg来记录最后一个错误
xmlrpc_errors = 0 //是否使用XML-RPC的错误信息格式记录错误
xmlrpc_error_number = 0 // 用作 XML-RPC faultCode 元素的值。
html_errors = On  // 是否把输出中的函数等信息变为HTML链接
docref_root = http://manual/en/ // 如果html_errors开启了,这个链接的根路径是什么
fastcgi.logging = 0 // 是否把php错误抛出到fastcgi中

我们经常会被问到,error_reporting和display_errors有什么区别呢?这两个函数是完全不一样的。

PHP默认是会在日志和标准输出(如果是fpm模式标准输出就是页面)

error_reporting的参数是错误级别。表示什么样子的级别才应该触发错误。如果我们告诉PHP,所有错误级别都不需要触发错误,那么,不管是日志,还是页面,都不会显示这个错误,就相当于什么都没有发生。

display_errors是控制是否要在标准输出展示错误信息
log_errors则是控制是否要在日志中记录错误信息。

error_log是显示错误日志的位置,这个在php-fpm中往往会被重写,于是往往会发现的是cli和fpm的错误日志竟然不是在同一个文件中。

ignore_repeated_errors这个标记控制的是如果有重复的日志,那么就只会记录一条,比如下面的程序:

error_reporting(E_ALL);
ini_set('ignore_repeated_errors', 1);
ini_set('ignore_repeated_source', 1);

$a = $c; $a = $c; //E_NOTICE
//Notice: Undefined variable: c in /tmp/php/index.php on line 20

本来会出现两次NOTICE的,但是现在,只会出现一次了…

track_errors开启会把最后一个错误信息存储到变量里面去,这个可能在对记日志的时候会有一些用处吧。不过我觉得真是没啥用…

html_errors 和 docref_root
两个是个挺有人性化的配置,配置了这两个参数以后,我们返回的错误信息中如果有一些在文档中有的信息,就会变成链接形式。

error_reporting(E_ALL);
ini_set('html_errors', 1);
ini_set('docref_root', "https://secure.php.net/manual/zh/");

include("a2.php"); //E_WARNING

能让你快速定位到我们出现错误的地方。是不是很人性~

error_reporting

int error_reporting ([ int $level ] )

设置应该报告何种 PHP 错误

// 关闭所有PHP错误报告,会返回新的错误报告级别error_reporting;// Report simple running errorserror_reporting(E_ERROR | E_WARNING | E_PARSE);

如果不带参数就返回当前错误报告级别

php-fpm中的配置

error_log = /var/log/php-fpm/error.log // php-fpm自身的日志
log_level = notice // php-fpm自身的日志记录级别
php_flag[display_errors] = off // 覆盖php.ini中的某个配置变量,可被程序中的ini_set覆盖
php_value[display_errors] = off // 同php_flag
php_admin_value[error_log] = /tmp/www-error.log // 覆盖php.ini中的某个配置变量,不可被程序中的ini_set覆盖
php_admin_flag[log_errors] = on // 同php_admin_value
catch_workers_output = yes // 是否抓取fpmworker的输出
request_slowlog_timeout = 0 // 慢日志时长
slowlog = /var/log/php-fpm/www-slow.log // 慢日志记录

php-fpm的配置中也有一个error_log配置,这个很经常会和php.ini中的error_log配置弄混。但他们记录的东西是不一样的,php-fpm的error_log只记录php-fpm本身的日志,比如fpm启动,关闭。

而php.ini中的error_log是记录php程序本身的错误日志。

那么在php-fpm中要覆盖php.ini中的error_log配置,就需要使用到下面几个函数:

  • php_flag
  • php_value
  • php_admin_flag
  • php_admin_value

这四个函数admin的两个函数说明这个变量设置完之后,不能在代码中使用ini_set把这个变量重新赋值了。而php_flag/value就仍然以php代码中的ini_set为准。

slowlog是fpm记录的,可以使用request_slowlog_timeout设置判断慢日志的时长。

error_get_last

获取最后发生的错误,register_shutdown_function()常常用到

array error_get_last 

返回结果

Array(    [type] => 8    [message] => Undefined variable: a    [file] => C:WWWindex.php    [line] => 2)

总结

我们经常弄混的就是日志问题,以及某些级别的日志为何没有记录到日志中。最主要的是要看error_log,display_errors,
log_errors这三个配置,只是在看配置的时候,我们还要注意区分php.ini里面的配置是什么,php-fpm.ini里面的配置是什么。

好吧,我觉得弄懂这些配置,基本就没有php日志记录不了的WTF的问题了。

trigger_error

产生一个用户级别的 error/warning/notice 信息

bool trigger_error ( string $error_msg [, int $error_type = E_USER_NOTICE ] 

error_log

把错误信息发送到 web
服务器的错误日志,或者到一个文件里,文件不存在时会创建

bool error_log ( string $message [, int $message_type = 0 [, string $destination [, string $extra_headers ]]] )

message_type
设置错误应该发送到何处
0 message 发送到 PHP
的系统日志,使用操作系统的日志机制或者一个文件,取决于php.ini中
error_log 的设置。 这是个默认的选项。
1 message 发送到参数 destination 设置的邮件地址。 第四个参数
extra_headers 只有在这个类型里才会被用到。
2 不再是一个选项。
3 message 被发送到位置为 destination 的文件里。 字符 message
不会默认被当做新的一行。
4 message 直接发送到 SAPI 的日志处理程序

set_error_handler()

设置一个用户定义的错误处理函数来处理脚本中出现的错误

mixed set_error_handler ( callable $error_handler [, int $error_types = E_ALL | E_STRICT ] )

error_types 里指定的错误类型都会绕过 PHP
标准错误处理程序,除非回调函数返回了 FALSE 。error_reporting()
设置将不会起到作用而你的错误处理函数继续会被调用,在需要时你有责任使用
die()。
NOTE
以下级别的错误不能由用户定义的函数来处理: E_ERROR、 E_PARSE、
E_CORE_ERROR、 E_CORE_WARNING、 E_COMPILE_ERROR、
E_COMPILE_WARNING,和在 调用 set_error_handler()
函数所在文件中产生的大多数 E_STRICT

error_handler

handler ( int $errorLevel , string $errorMessage [, string $errfile [, int $errline [, array $errcontext ]]] )

errcontext, 是一个指向错误发生时活动符号表的 array。
也就是说,errcontext 会包含错误触发处作用域内所有变量的数组。
用户的错误处理程序不应该修改错误上下文。

set_exception_handler

设置一个用户定义的异常处理函数

<?phpfunction exception_handler($exception) {  echo "Uncaught exception: " , $exception->getMessage(), "n";}set_exception_handler('exception_handler');throw new Exception('Uncaught Exception');echo "Not Executedn";?>

register_shutdown_function

这个函数是在脚本结束之后运行的函数(不管是正常结束还是通过exit、发生错误结束)

php.ini中有关错误的配置

php错误机制总结

error_reporting = E_ALL  // 报告错误级别,什么级别的error_log = /tmp/php_errors.log // php中的错误显示的日志位置display_errors = On // 是否把错误展示在输出上,这个输出可能是页面,也可能是stdoutdisplay_startup_errors = On // 是否把启动过程的错误信息显示在页面上,记得上面说的有几个Core类型的错误是启动时候发生的,这个就是控制这些错误是否显示页面的。log_errors = On // 是否要记录错误日志log_errors_max_len = 1024 // 错误日志的最大长度ignore_repeated_errors = Off // 是否忽略重复的错误track_errors = Off // 是否使用全局变量$php_errormsg来记录最后一个错误xmlrpc_errors = 0 //是否使用XML-RPC的错误信息格式记录错误xmlrpc_error_number = 0 // 用作 XML-RPC faultCode 元素的值。html_errors = On  // 是否把输出中的函数等信息变为HTML链接docref_root = http://manual/en/ // 如果html_errors开启了,这个链接的根路径是什么fastcgi.logging = 0 // 是否把php错误抛出到fastcgi中

PHP默认是会在日志和标准输出(如果是fpm模式标准输出就是页面)
error_reporting的参数是错误级别。表示什么样子的级别才应该触发错误
display_errors是控制是否要在标准输出展示错误信息
log_errors则是控制是否要在日志中记录错误信息
error_log是显示错误日志的位置

发表评论

电子邮件地址不会被公开。 必填项已用*标注