PHP 錯誤處理
在 PHP 中,預(yù)設(shè)的錯誤處理很簡單。一條錯誤訊息會被傳送到瀏覽器,這則訊息帶有檔案名稱、行號以及描述錯誤的訊息。
PHP 錯誤處理
#在建立腳本和Web 應(yīng)用程式時,錯誤處理是一個重要的部分。如果您的程式碼缺少錯誤偵測編碼,那麼程式看起來很不專業(yè),也為安全風(fēng)險敞開了大門。
本教學(xué)介紹了 PHP 中一些最重要的錯誤偵測方法。
我們將為您解釋不同的錯誤處理方法:
· ? 簡單的"die()" 語句
· ? 自訂錯誤與錯誤觸發(fā)器
· ? 錯誤回報
#基本的錯誤處理:使用die() 函數(shù)
第一個實例展示了一個開啟文字檔案的簡單腳本:
<?php $open=fopen('error.txt','r'); echo $open; ?>
如果檔案不存在,您會得到以下類似這樣的錯誤:
Warning: fopen(error.txt) [function.fopen]: failed to open stream:
No such file or directory in /www/php/test/test.php on line 2
為了避免用戶得到類似上面的錯誤訊息,我們在訪問檔案之前檢測該檔案是否存在:
<?php header("Content-type:text/html;charset=utf-8"); if(!file_exists('error.txt')){ die("文件不存在"); }else{ $file=fopen('error.txt','r'); } ?>
現(xiàn)在,如果檔案不存在,您會得到類似這樣的錯誤訊息:
檔案不存在
比起之前的程式碼,上面的程式碼更有效,這是由於它採用了一個簡單的錯誤處理機(jī)制在錯誤之後終止了腳本。
然而,簡單地終止腳本並不總是恰當(dāng)?shù)姆绞?。讓我們研究一下用於處理錯誤的備選的 PHP 函數(shù)。
建立自訂錯誤處理器
#建立一個自訂的錯誤處理器非常簡單。我們很簡單地創(chuàng)建了一個專用函數(shù),可以在 PHP 中發(fā)生錯誤時呼叫該函數(shù)。
此函數(shù)必須有能力處理至少兩個參數(shù)(error level 和error message),但是可以接受最多五個參數(shù)(可選的:file, line-number 和error context):
error_function (error_level,error_message,error_file,error_line,error_context)
? ? ? 參數(shù) | ? ? ? 說明 |
#? error_level | 必要。為使用者定義的錯誤規(guī)定錯誤報告等級。必須是一個數(shù)字。請參閱下面的表格:錯誤報告層級。 |
? error_message | 必要。為使用者定義的錯誤規(guī)定錯誤訊息。 |
#? error_file | #可選。規(guī)定錯誤發(fā)生的檔案名稱。 |
? error_line | #可選。規(guī)定錯誤發(fā)生的行號。 |
? error_context | 可選。規(guī)定一個數(shù)組,包含了當(dāng)錯誤發(fā)生時在用的每個變數(shù)以及它們的值。 |
錯誤報告層級
#這些錯誤報告層級是用戶自訂的錯誤處理程序處理的不同類型的錯誤:
? ? ? 值 | ? ? ?常數(shù) | ? ? 說明 |
? ? 2 | E_WARNING | 非致命的run-time 錯誤。不暫停腳本執(zhí)行。 |
? ? ? #? ? 8 | E_NOTICE | run-time 通知。在腳本發(fā)現(xiàn)可能有錯誤時發(fā)生,但也可能在腳本正常運行時發(fā)生。 |
? ? ? ? ? 256 | ||
致命的使用者產(chǎn)生的錯誤。這類似於程式設(shè)計師使用 PHP 函數(shù) trigger_error() 設(shè)定的 E_ERROR。 |
? ? ? ? ? 1024 | #E_USER_NOTICE | 使用者產(chǎn)生的通知。這類似於程式設(shè)計師使用 PHP 函數(shù) trigger_error() 設(shè)定的 E_NOTICE。 |
? ? ? #? ? 4096 | ||
| ##E_RECOVERABLE_ERROR
| ? ? ? |
現(xiàn)在,讓我們建立一個處理錯誤的函數(shù):
<?php header("Content-type:text/html;charset=utf-8"); function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr<br>"; echo "腳本結(jié)束"; die(); } ?>
上面的程式碼是一個簡單的錯誤處理函數(shù)。當(dāng)它被觸發(fā)時,它會取得錯誤等級和錯誤訊息。然後它會輸出錯誤等級和訊息,並終止腳本。
現(xiàn)在,我們已經(jīng)建立了一個錯誤處理函數(shù),我們需要確定在何時觸發(fā)該函數(shù)。
設(shè)定錯誤處理程序
#PHP 的預(yù)設(shè)錯誤處理程序是內(nèi)建的錯誤處理程序。我們打算把上面的函數(shù)改造為腳本運行期間的預(yù)設(shè)錯誤處理程序。
可以修改錯誤處理程序,使其只應(yīng)用到某些錯誤,這樣腳本就能以不同的方式來處理不同的錯誤。然而,在本例中,我們打算針對所有錯誤來使用我們自訂的錯誤處理程序:
set_error_handler("customError");
由於我們希望我們的自訂函數(shù)能處理所有錯誤,set_error_handler() 只需要一個參數(shù),可以加入第二個參數(shù)來規(guī)定錯誤等級
##實例
我們結(jié)合上面所學(xué)的知識,嘗試輸出不存在的變量,來測試這個錯誤處理程序:
<?php header("Content-type:text/html;charset=utf-8"); // 錯誤處理函數(shù) function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr"; } // 設(shè)置錯誤處理函數(shù) set_error_handler("customError"); // 觸發(fā)錯誤 echo($test); //關(guān)閉了所有的錯誤顯示 error_reporting(0); //顯示所有錯誤 //error_reporting(E_ALL); //顯示所有錯誤,但不顯示提示 //error_reporting(E_ALL & ~ E_NOTICE); ?>
程式運行結(jié)果:
運行結(jié)果告訴我們錯誤等級為8 ,錯誤訊息是:不存在的變數(shù)Error: [8] Undefined variable: test
觸發(fā)錯誤
在腳本中使用者輸入資料的位置,當(dāng)使用者的輸入無效時觸發(fā)錯誤是很有用的。在 PHP 中,這個任務(wù)由trigger_error() 函數(shù)完成。
實例
在本例中,如果"test" 變數(shù)大於"1",就會發(fā)生錯誤:<?php header("Content-type:text/html;charset=utf-8"); $test=2; if ($test>1) { trigger_error("變量值必須小于等于 1"); } ?>程式運行結(jié)果:
Notice: ?變數(shù)值必須小於等於1 in D:\WWW\Advanced tutorial\error\error_1.php on line 6
#您可以在腳本中任何位置觸發(fā)錯誤,透過新增的第二個參數(shù),您能夠規(guī)定所觸發(fā)的錯誤等級。 可能的錯誤類型:· ? ?
E_USER_ERROR - 致命的使用者產(chǎn)生的 run-time 錯誤。錯誤無法恢復(fù)。腳本執(zhí)行被中斷。
· ? ?E_USER_WARNING - 非致命的使用者產(chǎn)生的 run-time 警告。腳本執(zhí)行不被中斷。
·????E_USER_NOTICE - 預(yù)設(shè)。使用者產(chǎn)生的 run-time 通知。在腳本發(fā)現(xiàn)可能有錯誤時發(fā)生,但也可能在腳本正常運行時發(fā)生。
實例
在本例中,如果 "test" 變數(shù)大於 "1",則發(fā)生 E_USER_WARNING 錯誤。如果發(fā)生了E_USER_WARNING,我們將使用我們自訂的錯誤處理程序並結(jié)束腳本:
<?php header("Content-type:text/html;charset=utf-8"); // 錯誤處理函數(shù) function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr<br>"; echo "腳本結(jié)束"; die(); } // 設(shè)置錯誤處理函數(shù) set_error_handler("customError",E_USER_WARNING); // 觸發(fā)錯誤 $test=2; if ($test>1) { trigger_error("變量值必須小于等于 1",E_USER_WARNING); } ?>
程式運行結(jié)果:
運行結(jié)果告訴我們錯誤等級的值為512 錯誤訊息變成了我們用trigger_error函數(shù)設(shè)定的提示訊息##Error: [512] 變數(shù)值必須小於等於1腳本結(jié)束
#錯誤日誌記錄
#在某些公司裡面,有專門的日誌收集系統(tǒng)。日誌收集系統(tǒng)會在背後默默的幫你收集錯誤、警告、提示。 也有些公司沒有專門的日誌收集系統(tǒng),透過檔案來伺服器當(dāng)中的運行日誌。 其中:PHP的錯誤,警告這些是必須要收信的。 那麼問題來了-不讓使用者看到,設(shè)定好錯誤報告等級好,如何將錯誤收集到日誌系統(tǒng)呢? 這裡有需要使用到php.ini的相關(guān)設(shè)定項。這兩個組態(tài)項目為:
錯誤訊息類型 ##? ? | ? 說明 |
傳送至預(yù)設(shè)的error_log指定位置 | |
傳送至指定的郵件位置 | |
寄至指定的檔案位置 |