快捷導(dǎo)航

PHP set_error_handler()函數(shù)使用詳解（示例）

更新時(shí)間：2013年11月12日 14:10:32 作者：

本文詳細(xì)介紹PHP set_error_handler()函數(shù)的使用方法，最后還提供了一個(gè)實(shí)例

我們寫(xiě)程序，難免會(huì)有問(wèn)題（是經(jīng)常會(huì)遇到問(wèn)題），而PHP遇到錯(cuò)誤時(shí)，就會(huì)給出出錯(cuò)腳本的位置、行數(shù)和原因。有很多人說(shuō)，這并沒(méi)有什么大不了。確實(shí)，在調(diào)試程序階段，這確實(shí)是沒(méi)啥的，而且我認(rèn)為給出錯(cuò)誤路徑是必要的。
但泄露了實(shí)際路徑的后果是不堪設(shè)想的，對(duì)于某些入侵者，這個(gè)信息可是非常重要，而事實(shí)上現(xiàn)在有很多的服務(wù)器都存在這個(gè)問(wèn)題。有些網(wǎng)管干脆把PHP配置文件中的display_errors設(shè)置為Off來(lái)解決（貌似我們就是這樣做的），但本人認(rèn)為這個(gè)方法過(guò)于消極。
有些時(shí)候，我們的確需要PHP返回錯(cuò)誤的信息以便調(diào)試。而且在出錯(cuò)時(shí)也可能需要給用戶一個(gè)交待，甚至導(dǎo)航到另一頁(yè)面。那么，有啥解決辦法呢？
set_error_handler()
PHP從4.1.0開(kāi)始提供了自定義錯(cuò)誤處理句柄的功能函數(shù)set_error_handler()，但很少數(shù)腳本編寫(xiě)者知道。set_error_handler這個(gè)函數(shù)可以很好地防止錯(cuò)誤路徑泄露，當(dāng)然還有其它更多的作用。
可以用來(lái)屏蔽錯(cuò)誤。出現(xiàn)錯(cuò)誤一來(lái)會(huì)把一些信息暴漏給用戶，極有可能成為黑客攻擊你網(wǎng)站的工具。二來(lái)讓用戶覺(jué)得你的水平很挫。
可以記下錯(cuò)誤的信息，及時(shí)發(fā)現(xiàn)一些生產(chǎn)環(huán)境的出現(xiàn)的問(wèn)題。
可以做相應(yīng)的處理，出錯(cuò)的時(shí)候可以顯示跳轉(zhuǎn)到預(yù)先定義好的出錯(cuò)頁(yè)面，提供更好的用戶體驗(yàn)。
可以作為調(diào)試工具，一些時(shí)候必須在生產(chǎn)環(huán)境調(diào)試一些東西，但又不想影響正在使用的用戶。
set_error_handler的使用方法如下：

復(fù)制代碼代碼如下:

string set_error_handler ( callback error_handler [, int error_types])

現(xiàn)在我們就用自定義的錯(cuò)誤處理把實(shí)際路徑過(guò)濾掉。假設(shè)有一個(gè)變量$admin，我們是用來(lái)判斷訪問(wèn)者是否是管理員的（可以通過(guò)IP或者登錄的用戶id來(lái)做這個(gè)判斷）

復(fù)制代碼代碼如下:

//admin為管理員的身份判定，true為管理員。  
//自定義的錯(cuò)誤處理函數(shù)一定要有這４個(gè)輸入變量$errno,$errstr,$errfile,$errline，否則無(wú)效。  
function my_error_handler($errno,$errstr,$errfile,$errline)  
{  
    //如果不是管理員就過(guò)濾實(shí)際路徑  
    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) \n";  
        echo "程序已經(jīng)停止運(yùn)行，請(qǐng)聯(lián)系管理員。";  
        //遇到Error級(jí)錯(cuò)誤時(shí)退出腳本  
        exit;  
        break;  

        case E_WARNING:  
        echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile) \n";  
        break;  

        default:  
        //不顯示Notice級(jí)的錯(cuò)誤  
        break;  
    }  
}  

這樣就自定義了一個(gè)錯(cuò)誤處理函數(shù)，那么怎么把錯(cuò)誤的處理交給這個(gè)自定義函數(shù)呢？

復(fù)制代碼代碼如下:

// 應(yīng)用到類  
set_error_handler(array(&$this,"appError"));  

//示例的做法  
set_error_handler("my_error_handler");  

so easy，這樣，就可以很好地解決安全和調(diào)試方便的矛盾了。而且你還可以花點(diǎn)心思，使錯(cuò)誤提示更加美觀以配合網(wǎng)站的風(fēng)格。
原作者給出了兩點(diǎn)需要注意的地方，我也放出來(lái)吧，希望引起廣大同胞們的注意：
1、E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、 E_COMPILE_ERROR、E_COMPILE_WARNING是不會(huì)被這個(gè)句柄處理的，也就是會(huì)用最原始的方式顯示出來(lái)。不過(guò)出現(xiàn)這些錯(cuò)誤都是編譯或PHP內(nèi)核出錯(cuò)，在通常情況下不會(huì)發(fā)生。
2、使用set_error_handler()后，error_reporting ()將會(huì)失效。也就是所有的錯(cuò)誤（除上述的錯(cuò)誤）都會(huì)交給自定義的函數(shù)處理。
最后，出一個(gè)示例

復(fù)制代碼代碼如下:

//先定義一個(gè)函數(shù)，也可以定義在其他的文件中，再用require()調(diào)用  
function myErrorHandler($errno, $errstr, $errfile, $errline)  
{  
　　　　　//為了安全起見(jiàn)，不暴露出真實(shí)物理路徑，下面兩行過(guò)濾實(shí)際路徑  
    $errfile=str_replace(getcwd(),"",$errfile);  
    $errstr=str_replace(getcwd(),"",$errstr);  

    switch ($errno) {  
    case E_USER_ERROR:  

     echo "<b>My ERROR</b> [$errno] $errstr<br />\n";  
        echo "  Fatal error on line $errline in file $errfile";  
        echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";  
        echo "Aborting...<br />\n";  
        exit(1);  
        break;  

    case E_USER_WARNING:  
        echo "<b>My WARNING</b> [$errno] $errstr<br />\n";  
        break;  

    case E_USER_NOTICE:  
        echo "<b>My NOTICE</b> [$errno] $errstr<br />\n";  
        break;  

    default:  
        echo "Unknown error type: [$errno] $errstr<br />\n";  
        break;  
    }  

    /* Don't execute PHP internal error handler */  
    return true;  
}  

//下面開(kāi)始連接MYSQL服務(wù)器，我們故意指定MYSQL端口為3333,實(shí)際為3306。  
$link_id=@mysql_pconnect("localhost:3333","root","password");  
set_error_handler(myErrorHandler);  
if (!$link_id) {  
    trigger_error("出錯(cuò)了", E_USER_ERROR);  
}  