PHP的錯(cuò)誤機(jī)制也是非常復(fù)雜的，做了幾年php，也沒有仔細(xì)總結(jié)過，現(xiàn)在就補(bǔ)上這一課。

特別說明：文章的PHP版本使用5.5.32

[[177537]]

PHP的錯(cuò)誤級別

首先需要了解php有哪些錯(cuò)誤。截至到php5.5，一共有16個(gè)錯(cuò)誤級別

注意：嘗試下面的代碼的時(shí)候請確保打開error_log:

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

E_ERROR

這種錯(cuò)誤是致命錯(cuò)誤，會(huì)在頁面顯示Fatal Error， 當(dāng)出現(xiàn)這種錯(cuò)誤的時(shí)候，程序就無法繼續(xù)執(zhí)行下去了

錯(cuò)誤示例：

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

注意，如果有未被捕獲的異常，也是會(huì)觸發(fā)這個(gè)級別的。

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

這種錯(cuò)誤只是警告，不會(huì)終止腳本，程序還會(huì)繼續(xù)進(jìn)行，顯示的錯(cuò)誤信息是Warning。比如include一個(gè)不存在的文件。

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

這種錯(cuò)誤程度更為輕微一些，提示你這個(gè)地方不應(yīng)該這么寫。這個(gè)也是運(yùn)行時(shí)錯(cuò)誤，這個(gè)錯(cuò)誤的代碼可能在其他地方?jīng)]有問題，只是在當(dāng)前上下文情況下出現(xiàn)了問題。

比如$b變量不存在，我們把它賦值給另外一個(gè)變量

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

E_PARSE

這個(gè)錯(cuò)誤是編譯時(shí)候發(fā)生的，在編譯期發(fā)現(xiàn)語法錯(cuò)誤，不能進(jìn)行語法分析。

比如下面的z沒有設(shè)置為變量。

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

E_STRICT

這個(gè)錯(cuò)誤是PHP5之后引入的，你的代碼可以運(yùn)行，但是不是PHP建議的寫法。

比如在函數(shù)形參傳遞++符號

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

這個(gè)級別其實(shí)是ERROR級別的，但是它是期望被捕獲的，如果沒有被錯(cuò)誤處理捕獲，表現(xiàn)和E_ERROR是一樣的。

經(jīng)常出現(xiàn)在形參定義了類型，但調(diào)用的時(shí)候傳入了錯(cuò)誤類型。它的錯(cuò)誤提醒也比E_ERROR的fatal error前面多了一個(gè)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

這個(gè)錯(cuò)誤表示你用了一個(gè)舊版本的函數(shù)，而這個(gè)函數(shù)后期版本可能被禁用或者不維護(hù)了。

比如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

這兩個(gè)錯(cuò)誤是由PHP的引擎產(chǎn)生的，在PHP初始化過程中發(fā)生。

E_COMPILE_ERROR, E_COMPILE_WARNING

這兩個(gè)錯(cuò)誤是由PHP引擎產(chǎn)生的，在編譯過程中發(fā)生。

E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED,

這些錯(cuò)誤都是用戶制造的，使用trigger_error，這里就相當(dāng)于一個(gè)口子給用戶觸發(fā)出各種錯(cuò)誤類型。這個(gè)是一個(gè)很好逃避try catch異常的方式。

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

E_ALL

E_STRICT出外的所有錯(cuò)誤和警告信息。

錯(cuò)誤控制

php中有很多配置和參數(shù)是可以控制錯(cuò)誤，以及錯(cuò)誤的日志顯示的。***步，我們需要了解的是php中的有關(guān)錯(cuò)誤的配置有哪些？

我們按照php+php-fpm的模型來說，會(huì)影響php錯(cuò)誤顯示的其實(shí)是有兩個(gè)配置文件，一個(gè)是php本身的配置文件php.ini，另外一個(gè)是php-fpm的配置文件，php-fpm.conf。

php.ini中的配置

error_reporting = E_ALL  // 報(bào)告錯(cuò)誤級別，什么級別的 
 
error_log = /tmp/php_errors.log // php中的錯(cuò)誤顯示的日志位置 
 
display_errors = On // 是否把錯(cuò)誤展示在輸出上，這個(gè)輸出可能是頁面，也可能是stdout 
 
display_startup_errors = On // 是否把啟動(dòng)過程的錯(cuò)誤信息顯示在頁面上，記得上面說的有幾個(gè)Core類型的錯(cuò)誤是啟動(dòng)時(shí)候發(fā)生的，這個(gè)就是控制這些錯(cuò)誤是否顯示頁面的。 
 
log_errors = On // 是否要記錄錯(cuò)誤日志 
 
log_errors_max_len = 1024 // 錯(cuò)誤日志的***長度 
 
ignore_repeated_errors = Off // 是否忽略重復(fù)的錯(cuò)誤 
 
track_errors = Off // 是否使用全局變量$php_errormsg來記錄***一個(gè)錯(cuò)誤 
 
xmlrpc_errors = 0 //是否使用XML-RPC的錯(cuò)誤信息格式記錄錯(cuò)誤 
 
xmlrpc_error_number = 0 // 用作 XML-RPC faultCode 元素的值。 
 
html_errors = On  // 是否把輸出中的函數(shù)等信息變?yōu)镠TML鏈接 
 
docref_root = http://manual/en/ // 如果html_errors開啟了，這個(gè)鏈接的根路徑是什么 
 
fastcgi.logging = 0 // 是否把php錯(cuò)誤拋出到fastcgi中 

我們經(jīng)常會(huì)被問到，error_reporting和display_errors有什么區(qū)別呢？這兩個(gè)函數(shù)是完全不一樣的。

PHP默認(rèn)是會(huì)在日志和標(biāo)準(zhǔn)輸出（如果是fpm模式標(biāo)準(zhǔn)輸出就是頁面）

error_reporting的參數(shù)是錯(cuò)誤級別。表示什么樣子的級別才應(yīng)該觸發(fā)錯(cuò)誤。如果我們告訴PHP，所有錯(cuò)誤級別都不需要觸發(fā)錯(cuò)誤，那么，不管是日志，還是頁面，都不會(huì)顯示這個(gè)錯(cuò)誤，就相當(dāng)于什么都沒有發(fā)生。

display_errors是控制是否要在標(biāo)準(zhǔn)輸出展示錯(cuò)誤信息

log_errors則是控制是否要在日志中記錄錯(cuò)誤信息。

error_log是顯示錯(cuò)誤日志的位置，這個(gè)在php-fpm中往往會(huì)被重寫，于是往往會(huì)發(fā)現(xiàn)的是cli和fpm的錯(cuò)誤日志竟然不是在同一個(gè)文件中。

ignore_repeated_errors這個(gè)標(biāo)記控制的是如果有重復(fù)的日志，那么就只會(huì)記錄一條，比如下面的程序：

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 

本來會(huì)出現(xiàn)兩次NOTICE的，但是現(xiàn)在，只會(huì)出現(xiàn)一次了…

track_errors開啟會(huì)把***一個(gè)錯(cuò)誤信息存儲到變量里面去，這個(gè)可能在對記日志的時(shí)候會(huì)有一些用處吧。不過我覺得真是沒啥用…

html_errors 和 docref_root 兩個(gè)是個(gè)挺有人性化的配置，配置了這兩個(gè)參數(shù)以后，我們返回的錯(cuò)誤信息中如果有一些在文檔中有的信息，就會(huì)變成鏈接形式。

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

能讓你快速定位到我們出現(xiàn)錯(cuò)誤的地方。是不是很人性～

php-fpm中的配置

error_log = /var/log/php-fpm/error.log // php-fpm自身的日志 
log_level = notice // php-fpm自身的日志記錄級別 
php_flag[display_errors] = off // 覆蓋php.ini中的某個(gè)配置變量，可被程序中的ini_set覆蓋 
php_value[display_errors] = off // 同php_flag 
php_admin_value[error_log] = /tmp/www-error.log // 覆蓋php.ini中的某個(gè)配置變量，不可被程序中的ini_set覆蓋 
php_admin_flag[log_errors] = on // 同php_admin_value 
catch_workers_output = yes // 是否抓取fpmworker的輸出 
request_slowlog_timeout = 0 // 慢日志時(shí)長 
slowlog = /var/log/php-fpm/www-slow.log // 慢日志記錄 

php-fpm的配置中也有一個(gè)error_log配置，這個(gè)很經(jīng)常會(huì)和php.ini中的error_log配置弄混。但他們記錄的東西是不一樣的，php-fpm的error_log只記錄php-fpm本身的日志，比如fpm啟動(dòng)，關(guān)閉。

而php.ini中的error_log是記錄php程序本身的錯(cuò)誤日志。

那么在php-fpm中要覆蓋php.ini中的error_log配置，就需要使用到下面幾個(gè)函數(shù)：

• php_flag

• php_value

• php_admin_flag

• php_admin_value

這四個(gè)函數(shù)admin的兩個(gè)函數(shù)說明這個(gè)變量設(shè)置完之后，不能在代碼中使用ini_set把這個(gè)變量重新賦值了。而php_flag/value就仍然以php代碼中的ini_set為準(zhǔn)。

slowlog是fpm記錄的，可以使用request_slowlog_timeout設(shè)置判斷慢日志的時(shí)長。

總結(jié)

我們經(jīng)常弄混的就是日志問題，以及某些級別的日志為何沒有記錄到日志中。最主要的是要看error_log，display_errors, log_errors這三個(gè)配置，只是在看配置的時(shí)候，我們還要注意區(qū)分php.ini里面的配置是什么，php-fpm.ini里面的配置是什么。

好吧，我覺得弄懂這些配置，基本就沒有php日志記錄不了的WTF的問題了。