程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> PHP set_error_handler()函數的使用

PHP set_error_handler()函數的使用

編輯：關於PHP編程

我們寫程序，難免會有問題（是經常會遇到問題），而PHP遇到錯誤時，就會給出出錯腳本的位置、行數和原因。有很多人說，這並沒有什麼大不了。確實，在調試程序階段，這確實是沒啥的，而且我認為給出錯誤路徑是必要的。

但洩露了實際路徑的後果是不堪設想的，對於某些入侵者，這個信息可是非常重要，而事實上現在有很多的服務器都存在這個問題。有些網管干脆把PHP配置文件中的display_errors設置為Off來解決（貌似我們就是這樣做的），但本人認為這個方法過於消極。

有些時候，我們的確需要PHP返回錯誤的信息以便調試。而且在出錯時也可能需要給用戶一個交待，甚至導航到另一頁面。

那麼，有啥解決辦法呢？

set_error_handler()

PHP從4.1.0開始提供了自定義錯誤處理句柄的功能函數set_error_handler()，但很少數腳本編寫者知道。set_error_handler這個函數可以很好地防止錯誤路徑洩露，當然還有其它更多的作用。

可以用來屏蔽錯誤。出現錯誤一來會把一些信息暴漏給用戶，極有可能成為黑客攻擊你網站的工具。二來讓用戶覺得你的水平很挫。
可以記下錯誤的信息，及時發現一些生產環境的出現的問題。
可以做相應的處理，出錯的時候可以顯示跳轉到預先定義好的出錯頁面，提供更好的用戶體驗。
可以作為調試工具，一些時候必須在生產環境調試一些東西，但又不想影響正在使用的用戶。
。。。。

set_error_handler的使用方法如下：

string set_error_handler ( callback error_handler [, int error_types])

現在我們就用自定義的錯誤處理把實際路徑過濾掉。假設有一個變量$admin，我們是用來判斷訪問者是否是管理員的（可以通過IP或者登錄的用戶id來做這個判斷）

//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) \n";  
        echo "程序已經停止運行，請聯系管理員。";  
        //遇到Error級錯誤時退出腳本  
        exit;  
        break;  
  
        case E_WARNING:  
        echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile) \n";  
        break;  
  
        default:  
        //不顯示Notice級的錯誤  
        break;  
    }  
}

這樣就自定義了一個錯誤處理函數，那麼怎麼把錯誤的處理交給這個自定義函數呢？

// 應用到類  
set_error_handler(array(&$this,"appError"));  
  
//示例的做法  
set_error_handler("my_error_handler");

so easy，這樣，就可以很好地解決安全和調試方便的矛盾了。而且你還可以花點心思，使錯誤提示更加美觀以配合網站的風格。

原作者給出了兩點需要注意的地方，我也放出來吧，希望引起廣大同胞們的注意：

E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、 E_COMPILE_ERROR、E_COMPILE_WARNING是不會被這個句柄處理的，也就是會用最原始的方式顯示出來。不過出現這些錯誤都是編譯或PHP內核出錯，在通常情況下不會發生。
使用set_error_handler()後，error_reporting ()將會失效。也就是所有的錯誤（除上述的錯誤）都會交給自定義的函數處理。

最後，原作者又給出了一個示例（真是個認真負責的好人哈。）

//先定義一個函數，也可以定義在其他的文件中，再用require()調用  
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 />\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;  
}  
  
//下面開始連接MYSQL服務器，我們故意指定MYSQL端口為3333,實際為3306。  
$link_id=@mysql_pconnect("localhost:3333","root","password");  
set_error_handler(myErrorHandler);  
if (!$link_id) {  
    trigger_error("出錯了", E_USER_ERROR);  
}

好了，總結一下，下面是 set_error_handler 三種用法：

class CallbackClass {  
   function CallbackFunction() {  
       // refers to $this  
   }  
  
   function StaticFunction() {  
       // doesn't refer to $this  
   }  
}  
  
function NonClassFunction($errno, $errstr, $errfile, $errline) {  
}  
  
// 三種方法如下:  
  
1: set_error_handler('NonClassFunction');  // 直接轉到一個普通的函數 NonClassFunction  
  
2: set_error_handler(array('CallbackClass', 'StaticFunction')); // 轉到 CallbackClass 類下的靜方法 StaticFunction  
  
3: $o =& new CallbackClass();  
    set_error_handler(array($o, 'CallbackFunction'));  // 轉到類的構造函數，其實本質上跟下面的第四條一樣。  
  
4. $o = new CallbackClass();  
  
  
// The following may also prove useful:  
  
class CallbackClass {  
   function CallbackClass() {  
       set_error_handler(array(&$this, 'CallbackFunction')); // the & is important  
   }  
     
   function CallbackFunction() {  
       // refers to $this  
   }  
}