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");
這種錯誤只是警告,不會終止腳本,程式還會繼續進行,顯示的錯誤訊息是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
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的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_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.php.cn/upload.php"); curl_setopt($ch, CURLOPT_POSTFIELDS, array('fileupload' => '@'. "test"));
E_CORE_ERROR, E_CORE_WARNING
這兩個錯誤是由PHP的初始化引擎產生的,在PHPPHPPHP的初始化過程中發生的。
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_DEPRECATED
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
能讓你快速定位到我們出現錯誤的地方。是不是很人性~
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
這四個函數admin的兩個函數說明這個變數設定完之後,就不能在程式碼中使用ini_set把這個變數重新賦值了。而php_flag/value就還是以php程式碼中的ini_set為準。
我們經常弄混的就是日誌問題,以及某些等級的日誌為何沒有記錄到日誌中。最主要的是要看error_log,display_errors, log_errors這三個配置,只是在看配置的時候,我們還要注意區分php.ini裡面的配置是什麼,php-fpm.ini裡面的配置是什麼。