[技術分享] PHP錯誤與異常的日志記錄

 作者:新投云  發布于:2017-07-06  瀏覽數:

提到 Nginx + PHP 服務的錯誤日志,我們通常能想到的有 Nginx 的 access 日志、error 日志以及 PHP 的 error 日志。雖然看起來是個很簡單的問題,但里面其實又牽扯到應用配置以及日志記錄位置的問題,如果是在 ubuntu 等系統下使用 apt-get 的方式來安裝,其自有一套較為合理的的配置文件可用。再者運行的應用程序中的配置也會影響到日志記錄的方式及內容。

錯誤與異常的區別

關于錯誤與異常,我們可以用一個簡單的例子來理解:

<?php
try {
    1 / 0;
} catch (Exception $e) {
    echo "catched", PHP_EOL;
}

執行這個小示例會直接得到一個『PHP Warning: Division by zero …』錯誤。原因很簡單:這是邏輯錯誤,并不是異常,所以不能被 try 捕獲。同樣,對于變量使用前未定義這種問題,也是同樣的會產生 warning 而不是被捕獲。

但是這個問題在 PHP7 中卻有了一些改動,比如上面的例子中我把 / 改成 %,在 PHP7 的環境中執行會得到一個不一樣的提示:

PHP Fatal error: Uncaught DivisionByZeroError ...

根據這個提示,如果我把 catch 中的條件修改一下:

<?php
try {
    1 / 0;
} catch (DivisionByZeroError $e) {
    echo "catched", PHP_EOL;
}

這樣就可以正常捕獲到錯誤并輸出 catched 了。

對于第一個示例,同樣如果把 Excepiton 修改為 ErrorException 也可以正常捕獲。

至于為什么求余和除法,在 PHP5 中提示一致而在 PHP7(我的測試環境是 7.0.4) 中除法不屬于 DivisionByZeroError 的問題,這應該是個 BUG

日志的記錄

PHP 本身可配置的 log 大概有以下幾個:

  • php-fpm error log(php-fpm.conf 中配置,記錄 php-fpm 進程的啟動和終止等信息)

  • php-fpm slow log(也是在 php-fpm.conf 中配置,記錄慢執行)

  • php error log(php.ini 中配置,記錄應用程序的錯誤日志)

此外 Nginx 還有兩個可配置的log:access 和 error log。這幾個日志文件的功能不同,記錄的內容也不同。但其中有一個點需要注意:如果配置了 php-fpm 中的 error log 位置,但日志位置不可寫(配置時位置得是對的,因為 php-fpm 啟動時會做檢查),在適當的配置條件下錯誤日志會被返回到 cgi 中從而寫入 nginx 的 error log 中。

所以遇到問題是我們一般的查找思路都是:

  1. 到 Nginx access log 中查看請求的狀態碼

  2. 查看 php error log 中的錯誤記錄以及 stack 信息

  3. 查看 php-fpm log 中有無異常重啟記錄(如果核心或者擴展問題,會出現此情況)

但是在以上幾種情況下你也會發現,這里面并沒有上文提到的程序拋出異常的日志記錄。

異常記錄

異常不同于錯誤,嚴格上說它是應用程序邏輯的異常而不是錯誤,是可以通過合理的程序邏輯來手動觸發的。但大多情況下異常也是要進行記錄的,比如數據庫無法連接或者框架的不當使用觸發的異常,我們需要通過日志來定位問題并及時處理。

PHP 提供了兩個函數用于自定義處理錯誤和異常的方法:

  • set_error_handler

  • set_exception_handler

所以可以通過 set_exception_handler 函數注入方法捕獲所有的異常并記錄 。

相關文章

三期必中一期平特肖