攔截PHP各種異常和錯誤,發生致命錯誤時進行報警(一)

在日常開發中，大多數人的做法是在開發環境時開啟調試模式，在產品環境關閉調試模式。在開發的時候可以查看各種錯誤、異常，但是在線上就把錯誤顯示的關閉。
上面的情形看似很科學，有人解釋為這樣很安全，別人看不到錯誤，以免洩露重要信息...
但是你有沒有遇到這種情況，線下好好的，一上線卻運行不起來也找不到原因...
一個腳本，跑了好長一段時間，一直沒有問題，有一天突然中斷了，然後了也沒有任何記錄都不造啥原因...
線上一個付款，別人明明付了款，但是我們卻沒有記錄到，自己親自去實驗，卻是好的...
種種以上，都是因為大家關閉了錯誤信息，並且未將錯誤、異常記錄到日誌，導致那些隨機發生的錯誤很難追蹤。這樣矛盾就來了，即不要顯示錯誤，又要追蹤錯誤，這如何實現了？
以上問題都可以通過PHP的錯誤、異常機制及其內建函數'set_exception_handler','set_error_handler','register_shutdown_function' 來實現
'set_exception_handler' 函數 用於攔截各種未捕獲的異常，然後將這些交給用戶自定義的方式進行處理
'set_error_handler' 函數可以攔截各種錯誤，然後交給用戶自定義的方式進行處理
'register_shutdown_function' 函數是在PHP腳本結束時調用的函數，配合'error_get_last'可以獲取最後的致命性錯誤
這個思路大體就是把錯誤、異常、致命性錯誤攔截下來，交給我們自定義的方法進行處理，我們辨別這些錯誤、異常是否致命，如果是則記錄的資料庫或者文件系統，然後使用腳本不停的掃描這些日誌，發現嚴重錯誤立即發送郵件或發送簡訊進行報警
首先我們定義錯誤攔截類，該類用於將錯誤、異常攔截下來，用我們自己定義的處理方式進行處理，該類放在文件名為'errorHandler.class.php'中，代碼如下
/**
* 文件名稱：baseErrorHandler.class.php
* 摘    要：錯誤攔截器父類
*/
require 'errorHandlerException.class.php';//異常類
class errorHandler
{
    public $argvs = array();

    public     $memoryReserveSize = 262144;//備用內存大小

    private $_memoryReserve;//備用內存

    /**
     * 方      法：註冊自定義錯誤、異常攔截器
     * 參      數：void
     * 返      回：void
     */
    public function register()
    {
        ini_set('display_errors', 0);

        set_exception_handler(array($this, 'handleException'));//截獲未捕獲的異常

        set_error_handler(array($this, 'handleError'));//截獲各種錯誤 此處切不可掉換位置

        //留下備用內存 供後面攔截致命錯誤使用
        $this->memoryReserveSize > 0 && $this->_memoryReserve = str_repeat('x', $this->memoryReserveSize);

        register_shutdown_function(array($this, 'handleFatalError'));//截獲致命性錯誤
    }

    /**
     * 方      法：取消自定義錯誤、異常攔截器
     * 參      數：void
     * 返      回：void
     */
    public function unregister()
    {
        restore_error_handler();
        restore_exception_handler();
    }

    /**
     * 方      法：處理截獲的未捕獲的異常
     * 參      數：Exception $exception
     * 返      回：void
     */
    public function handleException($exception)
    {
        $this->unregister();
        try
        {
            $this->logException($exception);
            exit(1);
        }
        catch(Exception $e)
        {
            exit(1);
        }
    }

    /**
     * 方      法：處理截獲的錯誤
     * 參      數：int     $code 錯誤代碼
     * 參      數：string $message 錯誤信息
     * 參      數：string $file 錯誤文件
     * 參      數：int     $line 錯誤的行數
     * 返      回：boolean
     */
    public function handleError($code, $message, $file, $line)
    {
        //該處思想是將錯誤變成異常拋出 統一交給異常處理函數進行處理
        if((error_reporting() & $code) && !in_array($code, array(E_NOTICE, E_WARNING, E_USER_NOTICE, E_USER_WARNING, E_DEPRECATED)))
        {//此處只記錄嚴重的錯誤 對於各種WARNING NOTICE不作處理
            $exception = new errorHandlerException($message, $code, $code, $file, $line);
            $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
            array_shift($trace);//trace的第一個元素為當前對象 移除
            foreach($trace as $frame)
            {
                if($frame['function'] == '__toString')
                {//如果錯誤出現在 __toString 方法中 不拋出任何異常
                    $this->handleException($exception);
                    exit(1);
                }
            }
            throw $exception;
        }
        return false;
    }

    /**
     * 方      法：截獲致命性錯誤
     * 參      數：void
     * 返      回：void
     */
    public function handleFatalError()
    {
        unset($this->_memoryReserve);//釋放內存供下面處理程序使用

        $error = error_get_last();//最後一條錯誤信息
        if(errorHandlerException::isFatalError($error))
        {//如果是致命錯誤進行處理
            $exception = new errorHandlerException($error['message'], $error['type'], $error['type'], $error['file'], $error['line']);
            $this->logException($exception);
            exit(1);
        }
    }

    /**
     * 方      法：獲取伺服器IP
     * 參      數：void
     * 返      回：string
     */
    final public function getServerIp()
    {
        $serverIp = '';
        if(isset($_SERVER['SERVER_ADDR']))
        {
            $serverIp = $_SERVER['SERVER_ADDR'];
        }
        elseif(isset($_SERVER['LOCAL_ADDR']))
        {
            $serverIp = $_SERVER['LOCAL_ADDR'];
        }
        elseif(isset($_SERVER['HOSTNAME']))
        {
            $serverIp = gethostbyname($_SERVER['HOSTNAME']);
        }
        else
        {
            $serverIp = getenv('SERVER_ADDR');
        }        
        
        return $serverIp;
    }

    /**
     * 方      法：獲取當前URI信息
     * 參      數：void
     * 返      回：string $url
     */
    public function getCurrentUri()
    {
        $uri = '';
        if($_SERVER ["REMOTE_ADDR"])
        {//瀏覽器瀏覽模式
            $uri = 'http://' . $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'];
        }
        else
        {//命令行模式
            $params = $this->argvs;
            $uri = $params[0];
            array_shift($params);
            for($i = 0, $len = count($params); $i < $len; $i++)
            {
                $uri .= ' ' . $params[$i];
            }
        }
        return $uri;
    }

    /**
     * 方      法：記錄異常信息
     * 參      數：errorHandlerException $e 錯誤異常
     * 返      回：boolean 是否保存成功
     */
    final public function logException($e)
    {
        $error = array(
                        'add_time'     =>     time(),
                        'title'     =>     errorHandlerException::getName($e->getCode()),//這裡獲取用戶友好型名稱
                        'message'     =>     array(),
                        'server_ip' =>     $this->getServerIp(),
                        'code'         =>     errorHandlerException::getLocalCode($e->getCode()),//這裡為各種錯誤定義一個編號以便查找
                        'file'         =>  $e->getFile(),
                        'line'         =>     $e->getLine(),
                        'url'        =>  $this->getCurrentUri(),
                    );
        do
        {
            //$e->getFile() . ':' . $e->getLine() . ' ' . $e->getMessage() . '(' . $e->getCode() . ')'
            $message = (string)$e;
            $error['message'][] = $message;
        } while($e = $e->getPrevious());
        $error['message'] = implode("\r\n", $error['message']);
        $this->logError($error);
    }

    /**
     * 方      法：記錄異常信息
     * 參      數：array $error = array(
     *                                    'time' => int,
     *                                    'title' => 'string',
     *                                    'message' => 'string',
     *                                    'code' => int,
     *                                    'server_ip' => 'string'
     *                                     'file'     =>  'string',
     *                                    'line' => int,
     *                                    'url' => 'string',
     *                                );
     * 返      回：boolean 是否保存成功
     */
    public function logError($error)
    {
        /*這裡去實現如何將錯誤信息記錄到日誌*/
    }
}