PHPエラーのメカニズム

PHP のエラーメカニズムも非常に複雑ですが、私は数年間 PHP を使ってきましたが、このレッスンのために詳しくまとめていません。

特記事項: この記事の PHP バージョンは 5.5.32 を使用しています

PHP のエラーレベル

まず第一に、php にどのようなエラーがあるかを理解する必要があります。 php5.5 の時点では、合計 16 のエラー レベルがあります

注: 次のコードを試すときは、必ず error_log を開いてください:

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

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");

E_WARNING

このエラーは単なる警告であり、スクリプトは終了せず、プ​​ログラムは続行され、表示されるエラー メッセージは警告です。たとえば、存在しないファイルを含めます。

//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

E_NOTICE

このエラーはより軽微であり、この場所はこのように書かれるべきではないことを思い出させます。これも実行時エラーです。コードが間違っていると、他の場所では問題が発生せず、現在のコンテキストでのみ問題が発生する可能性があります。

たとえば、$b 変数が存在しないため、別の変数に割り当てます

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

E_PARSE

このエラーはコンパイル中に発生し、構文解析を実行できません。

例えば、以下のzは変数として設定されていません。

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

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_RECOVERABLE_ERROR

このレベルは実際にはERRORレベルですが、エラー処理で捕捉されない場合は捕捉されることが予想されます。性能はE_ERRORと同じです。

仮パラメータで型を定義しているのに、呼び出し時に間違った型が渡される場合によく発生します。そのエラー リマインダーには、E_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_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"));

E_CORE_ERROR、E_CORE_WARNING

これら 2 つのエラーは PHP エンジンによって生成され、PHP の初期化プロセス中に発生します。

E_COMPILE_ERROR、E_COMPILE_WARNING

これら 2 つのエラーは PHP エンジンによって生成され、コンパイル プロセス中に発生します。

E_USER_ERROR、E_USER_WARNING、E_USER_NOTICE、E_USER_DEPRECATED、

これらのエラーはすべてユーザーによって引き起こされ、trigger_error を使用すると、ユーザーに対してさまざまな種類のエラーをトリガーするホールが発生します。これは、try catch 例外を回避する良い方法です。

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

E_ALL

E_STRICT すべてのエラーと警告メッセージを出力します。

エラー制御

phpには、エラーとエラーログの表示を制御できる設定とパラメータが多数あります。最初のステップとして、PHP の間違った設定は何なのかを知る必要があります。

私たちは php+php-fpm モデルに従っています。実際には、php エラーの表示に影響を与える 2 つの設定ファイルがあります。1 つは php 自体の設定ファイル php.ini で、もう 1 つは 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

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

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_log，display_errors, log_errors这三个配置，只是在看配置的时候，我们还要注意区分php.ini里面的配置是什么，php-fpm.ini里面的配置是什么。

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

以上がPHPエラーのメカニズムの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。