PHP 錯(cuò)誤處理
PHP?錯(cuò)誤處理
在 PHP 中,預(yù)設(shè)的錯(cuò)誤處理很簡單。一條錯(cuò)誤訊息會(huì)被傳送到瀏覽器,這則訊息帶有檔案名稱、行號(hào)以及描述錯(cuò)誤的訊息。
PHP 錯(cuò)誤處理
在建立腳本和 Web 應(yīng)用程式時(shí),錯(cuò)誤處理是一個(gè)重要的部分。如果您的程式碼缺少錯(cuò)誤偵測編碼,那麼程式看起來很不專業(yè),也為安全風(fēng)險(xiǎn)敞開了大門。
本教學(xué)介紹了 PHP 中一些最重要的錯(cuò)誤偵測方法。
我們將為您解釋不同的錯(cuò)誤處理方法:
·???????? 簡單的"die()" 語句
·????????##·???????? 錯(cuò)誤回報(bào)
基本的錯(cuò)誤處理:使用die() 函數(shù)
第一個(gè)實(shí)例展示了一個(gè)簡單的腳本來開啟文字檔案:
<?php $file=fopen("welcome.txt","r"); ?>
如果檔案不存在,您會(huì)得到類似這樣的錯(cuò)誤:
Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:
No such file or directory in /www/test/test/test.php on line 2
為了避免使用者得到類似上面的錯(cuò)誤訊息,我們?cè)诖嫒n案之前偵測該檔案是否存在:
<?php if(!file_exists("welcome.txt")) { die("文件不存在"); } else { $file=fopen("welcome.txt","r"); } ?>
現(xiàn)在,如果檔案不存在,您會(huì)得到類似這樣的錯(cuò)誤訊息:
檔案不存在
相比之前的程式碼,上面的程式碼更有效,這是由於它採用了一個(gè)簡單的錯(cuò)誤處理機(jī)制在錯(cuò)誤之後終止了腳本。
然而,簡單地終止腳本並不總是恰當(dāng)?shù)姆绞?。讓我們研究一下用於處理錯(cuò)誤的備選的 PHP 函數(shù)。
建立自訂錯(cuò)誤處理器
建立一個(gè)自訂的錯(cuò)誤處理器非常簡單。我們很簡單地創(chuàng)建了一個(gè)專用函數(shù),可以在 PHP 中發(fā)生錯(cuò)誤時(shí)呼叫該函數(shù)。
此函數(shù)必須有能力處理至少兩個(gè)參數(shù)(error level 和error message),但是可以接受最多五個(gè)參數(shù)(可選的:file, line-number 和error context):
語法
error_function(error_level,error_message,
error_file,error_line,error_context)
#錯(cuò)誤報(bào)告層級(jí)
<?php function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr<br>"; echo "腳本結(jié)束"; die(); } ?>
上面的程式碼是一個(gè)簡單的錯(cuò)誤處理函數(shù)。當(dāng)它被觸發(fā)時(shí),它會(huì)取得錯(cuò)誤等級(jí)和錯(cuò)誤訊息。然後它會(huì)輸出錯(cuò)誤等級(jí)和訊息,並終止腳本。
現(xiàn)在,我們已經(jīng)建立了一個(gè)錯(cuò)誤處理函數(shù),我們需要確定在何時(shí)觸發(fā)該函數(shù)。
設(shè)定錯(cuò)誤處理程序
PHP 的預(yù)設(shè)錯(cuò)誤處理程序是內(nèi)建的錯(cuò)誤處理程序。我們打算把上面的函數(shù)改造為腳本運(yùn)行期間的預(yù)設(shè)錯(cuò)誤處理程序。
可以修改錯(cuò)誤處理程序,使其只應(yīng)用到某些錯(cuò)誤,這樣腳本就能以不同的方式來處理不同的錯(cuò)誤。然而,在本例中,我們打算針對(duì)所有錯(cuò)誤來使用我們自訂的錯(cuò)誤處理程序:
set_error_handler("customError");
由於我們希望我們的自訂函數(shù)能處理所有錯(cuò)誤,set_error_handler() 只需要一個(gè)參數(shù),可以加入第二個(gè)參數(shù)來規(guī)定錯(cuò)誤等級(jí)。
實(shí)例
透過嘗試輸出不存在的變量,來測試這個(gè)錯(cuò)誤處理程序:
<?php // 錯(cuò)誤處理函數(shù) function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr"; } // 設(shè)置錯(cuò)誤處理函數(shù) set_error_handler("customError"); // 觸發(fā)錯(cuò)誤 echo($test); ?>
以上程式碼的輸出如下:
Error : [8] Undefined variable: test
?觸發(fā)錯(cuò)誤
在腳本中使用者輸入資料的位置,當(dāng)使用者的輸入無效時(shí)觸發(fā)錯(cuò)誤是很有用的。在 PHP 中,這個(gè)任務(wù)由 trigger_error() 函數(shù)完成。
實(shí)例
在本例中,如果"test" 變數(shù)大於"1",就會(huì)發(fā)生錯(cuò)誤:
<?php $test=2; if ($test>1) { trigger_error("變量值必須小于等于 1"); } ?>
以上程式碼的輸出如下所示:
Notice: 變數(shù)值必須小於等於1
in /www/test/text.php on line 5
您可以在腳本中任何位置觸發(fā)錯(cuò)誤,透過新增的第二個(gè)參數(shù),您能夠規(guī)定所觸發(fā)的錯(cuò)誤等級(jí)。
可能的錯(cuò)誤類型:
·???????? E_USER_ERROR - 致命的使用者產(chǎn)生的 run-time 錯(cuò)誤。錯(cuò)誤無法恢復(fù)。腳本執(zhí)行被中斷。
·???????? E_USER_WARNING - 非致命的使用者產(chǎn)生的 run-time 警語。腳本執(zhí)行不被中斷。
·???????? E_USER_NOTICE - 預(yù)設(shè)。使用者產(chǎn)生的 run-time 通知。在腳本發(fā)現(xiàn)可能有錯(cuò)誤時(shí)發(fā)生,但也可能在腳本正常運(yùn)行時(shí)發(fā)生。
實(shí)例
在本例中,如果 "test" 變數(shù)大於 "1",則發(fā)生 E_USER_WARNING 錯(cuò)誤。如果發(fā)生了E_USER_WARNING,我們將使用我們自訂的錯(cuò)誤處理程序並結(jié)束腳本:
<?php // 錯(cuò)誤處理函數(shù) function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr<br>"; echo "腳本結(jié)束"; die(); } // 設(shè)置錯(cuò)誤處理函數(shù) set_error_handler("customError",E_USER_WARNING); // 觸發(fā)錯(cuò)誤 $test=2; if ($test>1) { trigger_error("變量值必須小于等于 1",E_USER_WARNING); } ?>
以上程式碼的輸出如下所示:
Error: [512] 變數(shù)值必須小於等於1
腳本結(jié)束
現(xiàn)在,我們已經(jīng)學(xué)習(xí)如何建立自己的error,以及如何觸發(fā)它們,接下來我們研究一下錯(cuò)誤記錄。
錯(cuò)誤記錄
在預(yù)設(shè)的情況下,根據(jù)在 php.ini 中的 error_log 配置,PHP 會(huì)向伺服器的記錄系統(tǒng)或檔案傳送錯(cuò)誤記錄。透過使用 error_log() 函數(shù),您可以向指定的檔案或遠(yuǎn)端目的地傳送錯(cuò)誤記錄。
透過電子郵件向自己發(fā)送錯(cuò)誤訊息,是一種獲得指定錯(cuò)誤的通知的好方法。
透過E-Mail 發(fā)送錯(cuò)誤訊息
在下面的範(fàn)例中,如果特定的錯(cuò)誤發(fā)生,我們將發(fā)送帶有錯(cuò)誤訊息的電子郵件,並結(jié)束腳本:
<?php // 錯(cuò)誤處理函數(shù) function customError($errno, $errstr) { echo "<b>Error:</b> [$errno] $errstr<br>"; echo "已通知網(wǎng)站管理員"; error_log("Error: [$errno] $errstr",1, "123123@qq.com","From: 123123@qq.com"); } // 設(shè)置錯(cuò)誤處理函數(shù) set_error_handler("customError",E_USER_WARNING); // 觸發(fā)錯(cuò)誤 $test=2; if ($test>1) { trigger_error("變量值必須小于等于 1",E_USER_WARNING); } ?>
以上程式碼的輸出如下所示:
Error: [512] 變數(shù)值必須小於等於1
已通知網(wǎng)站管理員
接收自以上程式碼的郵件如下所示:
Error: [512] 變數(shù)值必須小於等於1
這個(gè)方法不適合所有的錯(cuò)誤。常規(guī)錯(cuò)誤應(yīng)透過使用預(yù)設(shè)的 PHP 記錄系統(tǒng)在伺服器上進(jìn)行記錄。