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

在編寫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、處理處理程序應當包括：

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