日志紀錄：簡化版的日志接口

PHP日志接口規(guī)范

關(guān)于日志系統(tǒng)，PHP規(guī)范給出了相當好的說明和定義，請見： Logger Interface

1.17.1 簡化版

但在用過這么多開源框架進行各種項目開發(fā)，以及內(nèi)部框架的開發(fā)后，發(fā)現(xiàn)實際上日志的分類并沒有使用得這么豐富，而通常只是頻繁地幾類。因此，為了減少不必要的復(fù)雜性，這里特地精簡為三種，只有：

• error 系統(tǒng)異常類
• info 業(yè)務(wù)紀錄類
• debug 開發(fā)調(diào)試類

現(xiàn)分說如下。

(1)error 系統(tǒng)異常類

此類是后臺開發(fā)同學(xué)認為 不應(yīng)該發(fā)生卻發(fā)生的事情 ，即我們通常所說的系統(tǒng)異常。
如：調(diào)用app store支付的接口失敗了，我們需要紀錄一下當時的場景，以便復(fù)查和給用戶補嘗其損失。
又如：寫入一條紀錄到數(shù)據(jù)紀錄，但失敗了，我們需要紀錄一下，以便排查。

用法很簡單，如：

//只有描述
DI()->logger->error('fail to insert DB');

//描述 + 簡單的信息
DI()->logger->error('fail to insert DB', 'try to register user dogstar');

//描述 + 當時的上下文數(shù)據(jù)
$data = array('name' => 'dogstar', 'password' => '123456');
DI()->logger->error('fail to insert DB', $data);

上面三條紀錄，效果類如：

dogstar@ubuntu:dev.phalapi.com$ tailf ./Runtime/log/201502/20150207.log 
2015-02-07 20:37:55|ERROR|fail to insert DB
2015-02-07 20:37:55|ERROR|fail to insert DB|try to register user dogstar
2015-02-07 20:37:55|ERROR|fail to insert DB|{"name":"dogstar","password":"123456"}

截圖效果：

(2)info 業(yè)務(wù)紀錄類

此類通常為業(yè)務(wù)需要進行必要的操作紀錄，以便發(fā)生系統(tǒng)問題后的回滾處理、問題排查以及數(shù)據(jù)統(tǒng)計。
如在有緩存的情況下，可能數(shù)據(jù)沒及時寫入數(shù)據(jù)庫而導(dǎo)致數(shù)據(jù)丟失或者回檔，這里可以通過日志簡單查看是否可以恢復(fù)。以及說明一下操作發(fā)生的背景或原由，如通常游戲中用戶的經(jīng)驗值添加：

//假設(shè)：10 + 2 = 12
DI()->logger->info('add user exp', array('name' => 'dogstar', 'before' => 10, 'addExp' => 2, 'after' => 12, 'reason' => 'help one more phper'));

//對應(yīng)的LOG
2015-02-07 20:48:51|INFO|add user exp|{"name":"dogstar","before":10,"addExp":2,"after":12,"reason":"help one more phper"}

但當哪天我們看到以下的LOG是就會發(fā)現(xiàn)系統(tǒng)存在隱藏的BUG：

//WTF? 10 + 2 = 11 ???
2015-02-07 20:48:51|INFO|add user exp|{"name":"dogstar","before":10,"addExp":2,"after":11,"reason":"help one more phper"}

而當用戶玩家來投訴客服時，客服妹子來找到我們后臺開發(fā)時，我們可以證明得了是系統(tǒng)原因造成了用戶丟失1點經(jīng)驗值。
特別地，若我們看到以下的LOG時，不難看出有人在用非法的渠道刷經(jīng)驗：

2015-02-07 20:52:35|INFO|add user exp|{"name":"dogstar","before":10,"addExp":2,"after":12,"reason":"help one more phper"}
2015-02-07 20:52:35|INFO|add user exp|{"name":"dogstar","before":12,"addExp":2,"after":14,"reason":"help one more phper"}

....

2015-02-07 20:52:35|INFO|add user exp|{"name":"dogstar","before":998,"addExp":2,"after":1000,"reason":"help one more phper"}

所幸我們有日志并及時發(fā)現(xiàn)了，隨后如何處理就視具體的項目而定了。但當產(chǎn)品來追問時，我們可以及時給出反饋和做出處理。

還有更為重要的是 數(shù)據(jù)統(tǒng)計 。這塊就App數(shù)據(jù)分析和統(tǒng)計這塊已經(jīng)有了很好的第三方服務(wù)支持，一如：友盟。但我們?nèi)匀豢梢暂p松實現(xiàn)自己的數(shù)據(jù)統(tǒng)計，以便二次確認和定制化。畢竟，總是依賴第三方不是那么輕便，而且存在敏感數(shù)據(jù)安全問題。
這里簡單提供一個上報接口，如：

    public function getRules() {
        return array(
            'report' => array(
                'username' => array('name' => 'username', 'require' => true),
                'msg' => array('name' => 'msg', 'require' => true),
            ),
        );
    }

    public function report() {
        DI()->logger->info($this->username, $this->msg);
    }

客戶端在需要的場景，如用戶打開應(yīng)用，請求：

http://dev.phalapi.com/demo/?service=DogstarTest.Report&username=dogstar&msg=enter%20app

即可看到：

2015-02-07 21:01:13|INFO|dogstar|enter app

到后期，若我們需要統(tǒng)計用戶的登錄情況時，可以這樣統(tǒng)計：

$ cat ./Runtime/log/201502/20150207.log | grep "enter app" | awk -F '|' '{print $3}' | sort | uniq -c
     11 dogstar
      5 King
      2 Tom

(3)debug 開發(fā)調(diào)試類

此類為開發(fā)調(diào)試用，用法如上，這里不再贅述。以下是一些簡單的示例：

DI()->logger->debug('just for test');

DI()->logger->debug('just for test', '一些其他的描述 ...');

DI()->logger->debug('just for test', array('name' => 'dogstar', 'password' => '******'));

1.17.2 使用DI()->logger->log()進行更靈活的分類

若上面的error/info/debug都不能滿足項目的需求時，可以這樣更靈活地進行日志紀錄：

DI()->logger->log('demo', 'add user exp', array('name' => 'dogstar', 'after' => 12));
DI()->logger->log('test', 'add user exp', array('name' => 'dogstar', 'after' => 12));

//對應(yīng)的日志
2015-02-07 21:13:27|DEMO|add user exp|{"name":"dogstar","before":10,"addExp":2,"after":12,"reason":"help one more phper"}
2015-02-07 21:15:39|TEST|add user exp|{"name":"dogstar","after":12}

注意到，DI()->logger->log()第一個參數(shù)為日志分類的名稱，在寫入日志時會自動轉(zhuǎn)換為大寫。其接口函數(shù)簽名為：

    /**
     * 日志紀錄
     *
     * 可根據(jù)不同需要，將日志寫入不同的媒介
     *
     * @param string $type 日志類型，如：info/debug/error, etc
     * @param string $msg 日志關(guān)鍵描述
     * @param string/array $data 場景上下文信息
     * @return NULL
     */
    abstract public function log($type, $msg, $data);

1.17.3 別忘記了日志的級別設(shè)置

上面的三類日志分別對應(yīng)的標識為：

• error 系統(tǒng)異常類：PhalApi_Logger::LOG_LEVEL_ERROR
• info 業(yè)務(wù)紀錄類：PhalApi_Logger::LOG_LEVEL_INFO
• debug 開發(fā)調(diào)試類：PhalApi_Logger::LOG_LEVEL_DEBUG

根據(jù)不同的項目在不同環(huán)境下的需要，我們可以這樣有選擇性地將需要的日志分類寫入保存：

//日志紀錄
DI()->logger = new PhalApi_Logger_File(API_ROOT . '/Runtime',
    PhalApi_Logger::LOG_LEVEL_DEBUG | PhalApi_Logger::LOG_LEVEL_INFO | PhalApi_Logger::LOG_LEVEL_ERROR);

多個日志級別需要使用或運算進行組合。

1.17.4 擴展你的日志存儲

普遍情況下，我們認為將日志存放在文件是比較合理的，因為便于查看、管理和統(tǒng)計。當然，如果你的項目需要將日志紀錄在數(shù)據(jù)中，也可以快速擴展實現(xiàn)。如實現(xiàn)數(shù)據(jù)庫的存儲思路：

//$ vim ./Apps/Common/Logger/DB.php

class Common_Logger_DB extends PhalApi_Logger {

    public function log($type, $msg, $data) {
        //TODO 數(shù)據(jù)庫的日志寫入 ...
    } 

隨后，利用DI注冊一下即可：

//日志紀錄 - DB
DI()->logger = new Common_Logger_DB($dbConfig,
    PhalApi_Logger::LOG_LEVEL_DEBUG | PhalApi_Logger::LOG_LEVEL_INFO | PhalApi_Logger::LOG_LEVEL_ERROR);