PHP錯誤處理函數set_error_handler()的用法

定義和用法

set_error_handler() 函數設置用戶自定義的錯誤處理函數。 該函數用於建立運行時期間的用戶本身的錯誤處理方法。 該函數會返回舊的錯誤處理程序，若失敗，則返回 null。

語法

set_error_handler(error_function,error_types)  

參數	描述
error_function	必需。規定發生錯誤時運行的函數。
error_types	可選。規定在哪一個錯誤報告級別會顯示用戶定義的錯誤。默認是 "E_ALL"。

提示和註釋

提示：若是使用了該函數，會徹底繞過標準的 PHP 錯誤處理函數，若是必要，用戶定義的錯誤處理程序必須終止 (die() ) 腳本。 注意：若是在腳本執行前發生錯誤，因爲在那時自定義程序尚未註冊，所以就不會用到這個自定義錯誤處理程序。  

例子

<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline) {
	echo "<b>Custom error:</b> [$errno] $errstr<br />";
	echo "Error on line $errline in $errfile<br />";
	echo "Ending Script";
	die();
}

//set error handler
set_error_handler("customError");

$test=2;

//trigger error
if ($test > 1) {
	trigger_error("A custom error has been triggered");
}
?>

輸出：

Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfolder	est.php
Ending Script

 

---

 

須要注意的是：

set_error_handler("customError") 不只能夠接受函數，還能夠接受 類的方法（公開的靜態方法 及 公開的非靜態方法 均可以），但須要以 數組形式 傳遞，數組的第一值爲「類名」，第二個參數爲「方法名」，以下代碼所示：

<?php
class App{
	//error handler function
	function customError($errno, $errstr, $errfile, $errline) {
		echo "<b>Custom error:</b> [$errno] $errstr<br />";
		echo "Error on line $errline in $errfile<br />";
		echo "Ending Script";
		die();
	}
}

//set error handler
set_error_handler(array("App","customError"));

$test=2;

//trigger error
if ($test > 1) {
	trigger_error("A custom error has been triggered");
}
?>

 

錯誤路徑泄露

1.漏洞緣由： PHP遇到錯誤時，就會給出出錯腳本的位置、行數和緣由，例如：

Notice: Use of undefined constant test - assumed ''test'' in D:interpubbigflytest.php on line 3

有不少人說，這並無什麼大不了。但泄露了實際路徑的後果是不堪設想的，對於某些入侵者，這個信息但是很是重要，而事實上如今有不少的服務器都存在這個問題。 有些網管幹脆把PHP配置文件中的 display_errors 設置爲 Off 來解決，但本人認爲這個方法過於消極。有些時候，咱們的確須要PHP返回錯誤的信息以便調試。並且在出錯時也可能須要給用戶一個交待，甚至導航到另外一頁面。 2.漏洞解決： PHP從4.1.0開始提供了自定義錯誤處理句柄的功能函數 set_error_handler() ，但不多數腳本編寫者知道。在衆多的PHP論壇中，我只看見不多一部分對此狀況進行了處理。set_error_handler的使用方法以下：

string set_error_handler ( callback error_handler [, int error_types])

如今咱們就用自定義的錯誤處理把實際路徑過濾掉。

<?php
//admin爲管理員的身份斷定，true爲管理員。
//自定義的錯誤處理函數必定要有這４個輸入變量$errno,$errstr,$errfile,$errline，不然無效。
function my_error_handler($errno, $errstr, $errfile, $errline) {
	//若是不是管理員就過濾實際路徑
	if (!admin) {
		$errfile = str_replace(getcwd(), "", $errfile);
		$errstr = str_replace(getcwd(), "", $errstr);
	}

	switch ($errno) {
		case E_ERROR:
			echo "ERROR: [ID $errno] $errstr (Line: $errline of $errfile)";
			echo "程序已經中止運行，請聯繫管理員。";
			//遇到Error級錯誤時退出腳本
			exit;
		break;
		case E_WARNING:
			echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile)";
		break;
		default:
		//不顯示Notice級的錯誤
		break;
	}
}

//把錯誤處理設置爲my_error_handler函數
set_error_handler("my_error_handler");
...
?>

這樣，就能夠很好地解決安全和調試方便的矛盾了。並且你還能夠花點心思，使錯誤提示更加美觀以配合網站的風格。不過注意兩點是： （1）E_ERROR、 E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING是不會 被這個句柄處理的，也就是會用最原始的方式顯示出來。不過出現這些錯誤都是編譯或PHP內核出錯，在一般狀況下不會發生。 （2）使用set_error_handler()後，error_reporting ()將會失效。也就是全部的錯誤（除上述的錯誤）都會交給自定義的函數處理。 其它有關於set_error_handler()的信息，你們能夠參考PHP的官方手冊。 下面我舉個實際應用中的例子：

<index.php>

<?php
/**
 * 先定義一個錯誤處理函數，也能夠定義在其餘的文件中，再用require()調用
 *
 * @param $errno 錯誤編號
 * @param $errstr 錯誤消息
 * @param $errfile 錯誤所在的文件
 * @param $errline 錯誤所在的行
 * @return bool
 */
function myErrorHandler($errno, $errstr, $errfile, $errline) {

	// 爲了安全起見，不暴露出真實物理路徑，下面兩行過濾實際路徑
	$errfile = str_replace(getcwd(), "", $errfile);
	$errstr = str_replace(getcwd(), "", $errstr);
	switch ($errno) {
		case E_USER_ERROR:
			echo "<b>My ERROR</b> [$errno] $errstr<br />";
			echo "Fatal error on line $errline in file $errfile";
			echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />";
			echo "Aborting...<br />";
			exit(1);
			break;
		case E_USER_WARNING:
			echo "<b>My WARNING</b> [$errno] $errstr<br />";
			break;
		case E_USER_NOTICE:
			echo "<b>My NOTICE</b> [$errno] $errstr<br />";
			break;
		default:
			echo "Unknown error type: [$errno] $errstr<br />";
			break;
	}

	/* Don't execute PHP internal error handler */

	return true;
}

// 下面開始鏈接MYSQL服務器，咱們故意指定MYSQL端口爲3333,實際爲3306。
$link_id = @mysql_pconnect("localhost:3333", "root", "password");
set_error_handler(myErrorHandler);
if (!$link_id) {
	trigger_error("出錯了", E_USER_ERROR);
}
?>

 

 

 

延伸閱讀：

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

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