php 500錯誤的解決方法:1、檢查PHP腳本並修改;2、捕獲異常並記錄異常到日誌;3、分析日誌並處理即可。
本文操作環境:Windows7系統、PHP7.1版、Dell G3電腦。
如何解決php 500錯誤問題?
#PHP與500錯誤
PHP開發過程中經常會遇到返回500錯誤的情況,而且body體中也沒有任何調試(可用)內容。這時候你就需要慢慢調試了(打斷點,開調試模式等),但如果是現網,這個錯誤就比較讓人抓狂了,既不好打斷點也不能開調試模式。但既然是錯誤,總是會有處理方法,以下就一步步分析500的成因及處理方案。
0x01、500錯誤
500錯誤,也叫Internal Server Error(內部服務錯誤),表示服務因未知錯誤導致無法處理要求。在PHP站點中一般是由PHP傳回,也就是說,500錯誤一般都是PHP腳本的錯誤。
php-fpm抓包500
從上圖可以看出(Nginx PHP-FPM架構),在PHP呼叫一個不存在的類時,腳本發生錯誤並返回500給Nginx(並且將錯誤訊息也做了返回,只不過是卸載STDERR中)。
0x02、哪些錯誤異常會導致500
那麼哪一類錯誤會導致500錯誤呢,PHP所有的錯誤等級可以在PHP的官方文文檔(http ://php.net/manual/zh/errorfunc.constants.php)中查詢到,而這其中錯誤等級為E_ERROR、E_PARSE、E_RECOVERABLE_ERROR、E_USER_ERROR以及未捕獲的異常等都會導致500錯誤。
E_ERROR等級錯誤所導致的500
0x03、什麼情況下錯誤不會回傳500
#上面說了,這是PHP腳本的錯誤導致的,但PHP腳本有了錯誤或異常一定會導致500嗎?顯然不是,即使在腳本有致命錯誤的情況下,依舊可以回傳200。
display_errors設定選項
在基於python、nodejs等的web應用程式中,預設情況下,如果出現例外訊息會被列印到控制台( STDERR/STDOUT)中。而在基於PHP-FPM架構的PHP中沒有控制台可以列印,它的stderr和stdout被置為FastCGI中對應的STRDERR和STDOUT。如果將錯誤重新導向到STDOUT中,錯誤會直接輸出到回應中,且狀態碼也會置為200。這個也是display_errors選項所實現的能力。
display_errors選項的配置需要透過ini_set來實現,PHP文件中關於display_errors的配置表示該值為字串類型,實際使用中數字和布林類型也可以開啟或關閉該配置。
error_reporting配置
display_errors控制了PHP腳本發生錯誤時是否顯示錯誤詳情以及是否回傳錯誤狀態碼,而error_reporting項目則用來控制哪等級的錯誤可以直接印出來。
error_reporting的設定項目可以透過error_reporting(E_ALL)或ini_set('error_reporting', E_ALL)來配置,函數參數的詳情可以參考PHP文件。
要注意的是,PHP本身是有錯誤日誌的(error_log和log_errors兩個設定項目),若發生錯誤,PHP會將改錯誤寫入錯誤日誌中,而哪些錯誤需要被寫入是受error_reporting項的控制的。
在錯誤等級不符的情況下不顯示錯誤詳情
0x04、現網如何合理處理500
500錯誤發生已經說明PHP腳本無法正常運作了,這時候能做的只是捕獲異常並記錄異常到日誌,以方便日後的調試和現網bug的處理。
PHP自帶錯誤日誌
#PHP本身已經帶了錯誤日誌的記錄,可以在php.ini中將log_errors項目設定為On,並配合error_log配置項目來指定錯誤日誌的存放路徑。
錯誤日誌記錄開關
日誌路徑設定
該錯誤日誌的寫入不受display_errors的配置的控制。也就是說不管display_errors是否開啟,錯誤都會記錄到日誌中。但是卻受error_reporting配置的控制,如果目前錯誤等級跟error_reporting中的錯誤等級不符的話,錯誤不會寫入日誌中。也就是如果錯誤等級是E_ERROR,但是設定卻為error_reporting(E_NOTICE),那麼日誌中不會出現E_ERROR的出錯訊息。
PHP錯誤日誌記錄各種類型的錯誤
錯誤等級不符合導致的日誌不寫入
捕獲錯誤異常記錄
PHP提供了set_error_handler、register_shutdown_function、set_exception_handler、error_get_last等相關的錯誤處理函數。可以透過函數將捕獲到的錯誤訊息寫入指定日誌來實現錯誤的記錄。
函數的使用詳情可以參考http://km.oa.com/group/19368/articles/show/302491,這裡提供一個模版:
$previousHandler = set_exception_handler(function(Exception $ex) use (&$previousHandler) { call_user_func('exceptionHandler', $ex, $previousHandler); }); set_error_handler('errorHandler'); register_shutdown_function('fatalErrorHandler'); function exceptionHandler(Exception $ex, $previousHandler) { $info = array( $ex->getFile(), $ex->getLine(), $ex->getCode(), $ex->getMessage() ); // 记录日志 logPHPError($info); if (isset($previousHandler) && is_callable($previousHandler)) { call_user_func($previousHandler, $ex); } } /** * 框架错误处理函数 * @param $errno * @param $errstr * @param $errfile * @param $errline * @return bool */ function errorHandler($errno = 0, $errstr = '', $errfile = '', $errline = 0) { switch ($errno) { case E_WARNING: $errname = 'E_WARNING'; break; case E_NOTICE: $errname = 'E_NOTICE'; break; case E_STRICT: $errname = 'E_STRICT'; break; case E_RECOVERABLE_ERROR: $errname = 'E_RECOVERABLE_ERROR'; break; case E_DEPRECATED: $errname = 'E_DEPRECATED'; break; case E_USER_ERROR: $errname = 'E_USER_ERROR'; break; case E_USER_WARNING: $errname = 'E_USER_WARNING'; break; case E_USER_NOTICE: $errname = 'E_USER_NOTICE'; break; case E_USER_DEPRECATED: $errname = 'E_USER_DEPRECATED'; break; default: restore_error_handler(); return false; } // 记录日志 $info = array( $errfile, $errline, $errname, $errstr ); logPHPError($info); restore_error_handler(); return false; } /** * Fatal error错误处理 */ function fatalErrorHandler() { if (($e = error_get_last()) && $e['type'] === E_ERROR) { $info = array( $e['file'], $e['line'], 'E_ERROR', $e['message'] ); // 记录日志 logPHPError($info); } }
0x05 總結
總結起來,error_reporting是用來控制向瀏覽器或PHP錯誤日誌輸出錯誤訊息等級的函數或配置,而display_errors則是控制是否向瀏覽器輸出錯誤和警告訊息。
由於PHP的錯誤日誌是全域的,而且受到error_reporting的控制,因此建議在業務中實作自己的錯誤(例外)擷取記錄邏輯。
推薦學習:《PHP影片教學》
以上是如何解決php 500錯誤問題的詳細內容。更多資訊請關注PHP中文網其他相關文章!