關於PHP的錯誤機制總結

知識 08-31

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:Calltoundefinedfunctionhpinfo()in/tmp/php/index.phponline5hpinfo(); //E_ERROR

注意，如果有未被捕獲的異常，也是會觸發這個級別的。

//Fatal error: Uncaught exception Exception with message test exception in/tmp/php/index.php:5 Stack trace: #0 thrown in /tmp/php/index.php on line5throw new Exception("test exception");E_WARNING

這種錯誤只是警告，不會終止腳本，程序還會繼續進行，顯示的錯誤信息是Warning。比如include一個不存在的文件。

//Warning: include(a.php): failed to open stream: No such file or directory in /tmp/php/index.php on line7//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_WARNINGE_NOTICE

這種錯誤程度更為輕微一些，提示你這個地方不應該這麼寫。這個也是運行時錯誤，這個錯誤的代碼可能在其他地方沒有問題，只是在當前上下文情況下出現了問題。

比如$b變數不存在，我們把它賦值給另外一個變數

//Notice: Undefined variable: b in /tmp/php/index.php on line9$a = $b;//E_NOTICEE_PARSE

這個錯誤是編譯時候發生的，在編譯期發現語法錯誤，不能進行語法分析。

比如下面的z沒有設置為變數。

// Parseerror: syntaxerror, unexpected = in/tmp/php/index.php on line20z=1; // E_PARSEE_STRICT

這個錯誤是PHP5之後引入的，你的代碼可以運行，但是不是PHP建議的寫法。

比如在函數形參傳遞++符號

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

這個級別其實是ERROR級別的，但是它是期望被捕獲的，如果沒有被錯誤處理捕獲，表現和E_ERROR是一樣的。

經常出現在形參定義了類型，但調用的時候傳入了錯誤類型。它的錯誤提醒也比E_ERROR的fatal error前面多了一個Catachable的字樣。

//Catchable fatal error: Argument1passedtotestCall() must be aninstanceofA,instanceofB given, calledin/tmp/php/index.php on line37and definedin/tmp/php/index.php on line33class A { } class B { }functiontestCall(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

這兩個錯誤是由PHP的引擎產生的，在PHP初始化過程中發生。

E_COMPILE_ERROR, E_COMPILE_WARNING

這兩個錯誤是由PHP引擎產生的，在編譯過程中發生。

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_DEPRECATEDE_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 =//是否使用XML-RPC的錯誤信息格式記錄錯誤 xmlrpc_error_number =//用作 XML-RPC faultCode 元素的值。 html_errors = On//是否把輸出中的函數等信息變為HTML鏈接 docref_root = http://manual/en///如果html_errors開啟了，這個鏈接的根路徑是什麼 fastcgi.logging =//是否把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 line20

本來會出現兩次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_flagphp_admin_value[error_log]= /tmp/www-error.log // 覆蓋php.ini中的某個配置變數，不可被程序中的ini_set覆蓋php_admin_flag[log_errors]=on// 同php_admin_valuecatch_workers_output=yes// 是否抓取fpmworker的輸出request_slowlog_timeout=// 慢日誌時長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的問題了。