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