PHP中的錯誤處理、異常處理機制詳解

在編寫PHP程序時，錯誤處理是一個重要的部分。若是程序中缺乏錯誤檢測代碼，那麼看上去很不專業，也爲安全風險敞開了大門

例：

<?php
    $a = fopen('test.txt','r');
    //這裏並無對文件進行判斷就打開了，若是文件不存在就會報錯
?>

那麼正確的寫法應該以下：

<?php
    if (file_exists('test.txt')) {
        $f = fopen('test.txt', 'r');
        // 使用完後關閉
        fclose($f);
    }
?>

1、PHP錯誤處理的三種方式

A、簡單的die()語句；

等價於exit();

例：

if (!file_exists('aa.txt')) {
	die('文件不存在');
} else {
	// 執行操做
}
// 若是上面die()被觸發，那麼這裏echo接不被執行
echo 'ok';

簡潔寫法：

file_exits('aaa.txt') or die('文件不存在');
echo 'ok';

B、自定義錯誤和錯誤觸發器

一、錯誤處理器（自定義錯誤，通常用於語法錯誤處理）

建立自定義錯誤函數（處理器），該函數必須有能力處理至少兩個參數（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 的一部分）

二、錯誤觸發器（通常用於處理邏輯上的錯誤）

需求：好比要接收一個年齡，若是數字大於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");

2、PHP異常處理【重點】

一、基本語法  

<?php
try {
	// 可能出現錯誤或異常的代碼
	//catch 捕獲  Exception是PHP已定義好的異常類
} catch (Exception $e) {
	// 對異常處理，方法：
	//一、本身處理
	//二、不處理，能夠再次拋出 throw new Exception('xxx');
}
?>

二、處理處理程序應當包括：

1. try - 使用異常的函數應該位於 "try"  代碼塊內。若是沒有觸發異常，則代碼將照常繼續執行。可是若是異常被觸發，會拋出一個異常；
2. throw - 這裏規定如何觸發異常。每個 "throw" 必須對應至少一個 "catch"；
3. 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

例子解釋：

上面的代碼拋出了一個異常，並捕獲了它：

1. 建立 checkNum() 函數，它檢測數字是否大於 1，若是是，則拋出一個異常。
2. 在 "try" 代碼塊中調用 checkNum() 函數。
3. checkNum() 函數中的異常被拋出。
4. "catch" 代碼塊接收到該異常，並建立一個包含異常信息的對象 ($e)。
5. 經過從這個 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()的用法

PHP異常處理函數set_exception_handler()的用法

PHP 的異常處理、錯誤處理:error_reporting,try-catch,trigger_error,set_error_handler,set_exception_handler,register_shutdown_function