在編寫PHP程序時,錯誤處理是一個重要的部分。如果程序中缺少錯誤檢測代碼,那么看上去很不專業,也為安全風險敞開了大門
例:
<?php $a = fopen('test.txt','r'); //這里並沒有對文件進行判斷就打開了,如果文件不存在就會報錯 ?>
那么正確的寫法應該如下:
<?php if (file_exists('test.txt')) { $f = fopen('test.txt', 'r'); // 使用完后關閉 fclose($f); } ?>
一、PHP錯誤處理的三種方式
A、簡單的die()語句;
等價於exit();
例:
if (!file_exists('aa.txt')) { die('文件不存在'); } else { // 執行操作 } // 如果上面die()被觸發,那么這里echo接不被執行 echo 'ok';
簡潔寫法:
file_exits('aaa.txt') or die('文件不存在'); echo 'ok';
B、自定義錯誤和錯誤觸發器
1、錯誤處理器(自定義錯誤,一般用於語法錯誤處理)
創建自定義錯誤函數(處理器),該函數必須有能力處理至少兩個參數(error_level和errormessage),但是可以接受最多五個參數(error_file、error_line、error_context)
語法:
function error_function($error_level, $error_message, $error_file, $error_line, $error_context)
// 創建好后還需要改寫set_error_handler();函數
set_error_handler('error_function', E_WARNING); // 這里error_function對應上面創建的自定義處理器名,第二個參數為使用自定義錯誤處理器的錯誤級別;
錯誤報告級別(了解即可)
這些錯誤報告級別是錯誤處理程序旨在處理的錯誤的不同的類型:
值 | 常量 | 描述 |
---|---|---|
2 | E_WARNING | 非致命的 run-time 錯誤。不暫停腳本執行。 |
8 | E_NOTICE | Run-time 通知。腳本發現可能有錯誤發生,但也可能在腳本正常運行時發生。 |
256 | E_USER_ERROR | 致命的用戶生成的錯誤。這類似於程序員使用 PHP 函數 trigger_error() 設置的 E_ERROR。 |
512 | E_USER_WARNING | 非致命的用戶生成的警告。這類似於程序員使用 PHP 函數 trigger_error() 設置的 E_WARNING。 |
1024 | E_USER_NOTICE | 用戶生成的通知。這類似於程序員使用 PHP 函數 trigger_error() 設置的 E_NOTICE。 |
4096 | E_RECOVERABLE_ERROR | 可捕獲的致命錯誤。類似 E_ERROR,但可被用戶定義的處理程序捕獲。(參見 set_error_handler()) |
8191 | E_ALL | 所有錯誤和警告,除級別 E_STRICT 以外。(在 PHP 6.0,E_STRICT 是 E_ALL 的一部分) |
2、錯誤觸發器(一般用於處理邏輯上的錯誤)
需求:比如要接收一個年齡,如果數字大於120,就認為是一個錯誤
傳統方法:
<?php if ($age > 120) { echo '年齡錯誤'; exit(); } ?>
使用觸發器:
<?php if ($age > 120) { // trigger_error('錯誤信息'[,'錯誤等級']); 這里錯誤等級為可選項,用於定義該錯誤的級別 // 用戶定義的級別包含以下三種:E_USER_WARNING 、E_USER_ERROR 、E_USER_NOTICE trigger_error('年齡錯誤'); // 這里是調用的系統默認的錯誤處理方式,我們也可以用自定義處理器 } /** * 自定義處理器,與上面相同 */ function myerror($error_level, $error_message) { echo 'error text'; } // 同時需要改變系統默認的處理函數 set_error_handler('myerror', E_USER_WARNING); // 同上面,第一個參數為自定義函數的名稱,第二個為錯誤級別【這里的錯誤級別通常為以下三種:E_USER_WARNING 、E_USER_ERROR 、E_USER_NOTICE】 // 現在再使用trigger_error就可以使用自定義的錯誤處理函數了 ?>
練習題:
<?php date_default_timezone_set('PRC'); function myerror($error_level, $error_message) { $info = "錯誤號:$error_level"; $info .= "錯誤信息:$error_message"; $info .= '發生時間:' . date('Y-m-d H:i:s'); $filename = 'aa.txt'; if (!$fp = fopen($filename, 'a')) { echo '創建文件' . $filename . '失敗'; } if (is_writeable($filename)) { if (!fwrite($fp, $info)) { echo '寫入文件失敗'; } else { echo '已成功記錄錯誤信息'; } fclose($fp); } else { echo '文件' . $filename . '不可寫'; } exit(); } set_error_handler('myerror', E_WARNING); $fp = fopen('aaa.txt', 'r'); ?>
C、錯誤日志
默認的根據php.ini中error_log配置,PHP向服務器的錯誤記錄系統或文件發送錯誤記錄。通過使用error_log()函數可以向文件或遠程目的地發送錯誤記錄;
語法:
error_log(error[, type, destination, headers])
type部分一般用3,表示在文件后面追加錯誤信息,而不會覆蓋原內容destination表示目的地,即存放的文件或遠程目的地
如:error_log("$error_info",3,"errors.txt");
二、PHP異常處理【重點】
1、基本語法
<?php try { // 可能出現錯誤或異常的代碼 //catch 捕獲 Exception是PHP已定義好的異常類 } catch (Exception $e) { // 對異常處理,方法: //1、自己處理 //2、不處理,可以再次拋出 throw new Exception('xxx'); } ?>
2、處理處理程序應當包括:
- try - 使用異常的函數應該位於 "try" 代碼塊內。如果沒有觸發異常,則代碼將照常繼續執行。但是如果異常被觸發,會拋出一個異常;
- throw - 這里規定如何觸發異常。每一個 "throw" 必須對應至少一個 "catch";
- catch - "catch" 代碼塊會捕獲異常,並創建一個包含異常信息的對象;
讓我們觸發一個異常:
<?php /** * 創建可拋出一個異常的函數 */ function checkNum($number) { if ($number > 1) { throw new Exception("Value must be 1 or below"); } return true; } // 在 "try" 代碼塊中觸發異常 try { checkNum(2); // 如果異常被拋出,那么下面一行代碼將不會被輸出 echo 'If you see this, the number is 1 or below'; } catch (Exception $e) { // 捕獲異常 echo 'Message: ' . $e->getMessage(); } ?>
上面代碼將獲得類似這樣一個錯誤:
Message: Value must be 1 or below
例子解釋:
上面的代碼拋出了一個異常,並捕獲了它:
- 創建 checkNum() 函數,它檢測數字是否大於 1,如果是,則拋出一個異常。
- 在 "try" 代碼塊中調用 checkNum() 函數。
- checkNum() 函數中的異常被拋出。
- "catch" 代碼塊接收到該異常,並創建一個包含異常信息的對象 ($e)。
- 通過從這個 exception 對象調用 $e->getMessage(),輸出來自該異常的錯誤消息。
不過,為了遵循“每個 throw 必須對應一個 catch”的原則,可以設置一個頂層的異常處理器來處理漏掉的錯誤。
set_exception_handler()函數可設置處理所有未捕獲異常的用戶定義函數。
<?php /** * 設置一個頂級異常處理器 */ function myexception($e) { echo 'this is top exception'; } // 修改默認的異常處理器 set_exception_handler("myexception"); try { $i = 5; if ($i < 10) { throw new Exception('$i must greater than 10'); } } catch (Exception $e) { // 處理異常 echo $e->getMessage() . '<br/>'; // 不處理異常,繼續拋出 throw new Exception('errorinfo'); // 也可以用throw $e 保留原錯誤信息; } ?>
創建一個自定義的異常類
<?php class customException extends Exception { public function errorMessage() { $errorMsg = 'Error on line ' . $this->getLine() . ' in ' . $this->getFile() . ': <b>' . $this->getMessage() . '</b> is not a valid E-Mail address'; return $errorMsg; } } // 使用 try { throw new customException('error message'); } catch (customException $e) { echo $e->errorMessage(); } ?>
可以使用多個catch來返回不同情況下的錯誤信息
<?php try { $i = 5; if ($i > 0) { throw new customException('error message'); // 使用自定義異常類處理 } if ($i < -10) { throw new Exception('error2'); // 使用系統默認異常處理 } } catch (customException $e) { echo $e->getMessage(); } catch (Exception $e1) { echo $e1->getMessage(); } ?>
異常的規則
- 需要進行異常處理的代碼應該放入 try 代碼塊內,以便捕獲潛在的異常。
- 每個try或throw代碼塊必須至少擁有一個對應的 catch 代碼塊。
- 使用多個 catch 代碼塊可以捕獲不同種類的異常。
- 可以在try代碼內的catch 代碼塊中再次拋出(re-thrown)異常。
簡而言之:如果拋出了異常,就必須捕獲它。
延伸閱讀:
PHP錯誤處理函數set_error_handler()的用法