PHP日誌擴展 SeasLog-1.4.2 發布,支持錯誤與異常

SeasLog-1.4.2 發布！

SeasLog是一個輕量,高效,便捷,規範的PHP日誌擴展,精準的定位\精巧的設計,使它在PHP項目中逐步成為一個非常優秀的日誌工具.

Change log:

1.2.2

- Fixed Logger bug with PHP-Version -ge 5.4
- Fixed SeasLog::log('level','message','content',['logger']) bug
- Support SeasLog::analyzerDetail("all")
- Support SeasLog::analyzerCount("all")

1.2.3

- Fixed issue #44 Seaslog::analyzerDetail([with out 'all'])
- Support CONST SEASLOG_ALL

1.4.0

- Fixed issue #42 support error and exception automatic logging.
- Optimization performance, update is_dir with access.

1.4.2

- Fixed issue #47 support trace_error and trace_exception switch.
- Fixed issue #48 Ignore notice or warning, but error automatic logging.

附1：PECL項目主頁http://pecl.php.net/package/SeasLog

附2：GitHub項目主頁https://github.com/Neeke/SeasLog

SeasLog
Yet a log extension for PHP.A effective,fast,stable log extension for PHP
@author Chitao.Gao [[e-mail]]

為什麼使用SeasLog

log日誌，通常是系統或軟體、應用的運行記錄。通過log的分析，可以方便用戶了解系統或軟體、應用的運行情況；如果你的應用log足夠豐富，也可以分析以往用戶的操作行為、類型喜好、地域分布或其他更多信息；如果一個應用的log同時也分了多個級別，那麼可以很輕易地分析得到該應用的健康狀況，及時發現問題並快速定位、解決問題，補救損失。

php內置error_log、syslog函數功能強大且性能極好，但由於各種缺陷(error_log無錯誤級別、無固定格式，syslog不分模塊、與系統日誌混合)，靈活度降低了很多，不能滿足應用需求。

好消息是，有不少第三方的log類庫彌補了上述缺陷，如log4php、plog、Analog等(當然也有很多應用在項目中自己開發的log類)。其中以log4php最為著名，設計精良、格式完美、文檔完善、功能強大。推薦。

不過log4php在性能方面表現非常差,下圖是SeasLog與log4php的ab並發性能測試( 測試環境:Ubuntu12.04單機,CPU I3,內存 16G,硬碟 SATA 7200): 

那麼有沒有一種log類庫滿足以下需求呢：

• 分模塊、分級別

• 配置簡單(最好是勿須配置)

• 日誌格式清晰易讀

• 應用簡單、性能很棒

SeasLog 正是應此需求而生。

目前提供了什麼

• 在PHP項目中便捷、規範地記錄log

• 可配置的默認log目錄與模塊

• 指定log目錄與獲取當前配置

• 初步的分析預警框架

• 高效的日誌緩衝、便捷的緩衝debug

• 遵循 PSR-3 日誌接口規範

目標是怎樣的

• 便捷、規範的log記錄

• 高效的海量log分析

• 可配置、多途徑的log預警

安裝

編譯安裝 seaslog

$ /path/to/phpize$ ./configure --with-php-config=/path/to/php-config$ make && make install

seaslog.ini的配置

; configuration for php SeasLog moduleextension = seaslog.soseaslog.default_basepath = /log/seaslog-test    ;默認log根目錄seaslog.default_logger = default                ;默認logger目錄seaslog.disting_type = 1                        ;是否以type分文件 1是 0否(默認)seaslog.disting_by_hour = 1                     ;是否每小時劃分一個文件 1是 0否(默認)seaslog.use_buffer = 1                          ;是否啟用buffer 1是 0否(默認)seaslog.buffer_size = 100                       ;buffer中緩衝數量 默認0(不使用buffer_size)seaslog.level = 0                               ;記錄日誌級別 默認0(所有日誌)seaslog.trace_error = 0                         ;自動記錄錯誤 默認0(關閉)seaslog.trace_exception = 1                     ;自動記錄異常信息 默認1(開啟)

seaslog.disting_type = 1 開啟以type分文件，即log文件區分info\warn\erro

seaslog.disting_by_hour = 1 開啟每小時劃分一個文件

seaslog.use_buffer = 1 開啟buffer。默認關閉。當開啟此項時，日誌預存於內存，當請求結束時(或異常退出時)一次寫入文件。

常量與函數

常量列表

* SEASLOG_DEBUG                       "debug"* SEASLOG_INFO                        "info"* SEASLOG_NOTICE                      "notice"* SEASLOG_WARNING                     "warning"* SEASLOG_ERROR                       "error"* SEASLOG_CRITICAL                    "critical"* SEASLOG_ALERT                       "alert"* SEASLOG_EMERGENCY                   "emergency"var_dump(SEASLOG_DEBUG,SEASLOG_INFO,SEASLOG_NOTICE);/*string('debug') debug級別string('info')  info級別string('notice') notice級別*/

函數列表

SeasLog 提供了這樣一組函數，可以方便地獲取與設置根目錄、模塊目錄、快速寫入與統計log。 相信從下述偽代碼的注釋中，您可以快速獲取函數信息，具體使用將緊接其後：

<?php/** * @author [e-mail] * Date: 14-1-27 下午4:47 */class SeasLog{    public function __construct()    {        #SeasLog init    }    public function __destruct()    {        #SeasLog distroy    }    /**     * 設置basePath     * @param $basePath     * @return bool     */    static public function setBasePath($basePath)    {        return TRUE;    }    /**     * 獲取basePath     * @return string     */    static public function getBasePath()    {        return 'the base_path';    }    /**     * 設置模塊目錄     * @param $module     * @return bool     */    static public function setLogger($module)    {        return TRUE;    }    /**     * 獲取最後一次設置的模塊目錄     * @return string     */    static public function getLastLogger()    {        return 'the lastLogger';    }    /**     * 統計所有類型（或單個類型）行數     * @param $level     * @param string $log_path     * @return array | long     */    static public function analyzerCount($level = 'all',$log_path = '*')    {        return array();    }    /**     * 以數組形式，快速取出某類型log的各行詳情     * @param $level     * @param string $log_path     * @return array     */    static public function analyzerDetail($level = SEASLOG_INFO,$log_path = '*')    {        return array();    }    /**     * 獲得當前日誌buffer中的內容     * @return array     */    static public function getBuffer()    {        return array();    }    /**     * 記錄debug日誌     * @param $message     * @param array $content     * @param string $module     */    static public function debug($message,array $content = array(),$module = '')    {        #$level = SEASLOG_DEBUG    }    /**     * 記錄info日誌     * @param $message     * @param array $content     * @param string $module     */    static public function info($message,array $content = array(),$module = '')    {        #$level = SEASLOG_INFO    }    /**     * 記錄notice日誌     * @param $message     * @param array $content     * @param string $module     */    static public function notice($message,array $content = array(),$module = '')    {        #$level = SEASLOG_NOTICE    }    /**     * 記錄warning日誌     * @param $message     * @param array $content     * @param string $module     */    static public function warning($message,array $content = array(),$module = '')    {        #$level = SEASLOG_WARNING    }    /**     * 記錄error日誌     * @param $message     * @param array $content     * @param string $module     */    static public function error($message,array $content = array(),$module = '')    {        #$level = SEASLOG_ERROR    }    /**     * 記錄critical日誌     * @param $message     * @param array $content     * @param string $module     */    static public function critical($message,array $content = array(),$module = '')    {        #$level = SEASLOG_CRITICAL    }    /**     * 記錄alert日誌     * @param $message     * @param array $content     * @param string $module     */    static public function alert($message,array $content = array(),$module = '')    {        #$level = SEASLOG_ALERT    }    /**     * 記錄emergency日誌     * @param $message     * @param array $content     * @param string $module     */    static public function emergency($message,array $content = array(),$module = '')    {        #$level = SEASLOG_EMERGENCY    }    /**     * 通用日誌方法     * @param $level     * @param $message     * @param array $content     * @param string $module     */    static public function log($level,$message,array $content = array(),$module = '')    {    }}

SeasLog Logger的使用（詳細文檔）

使用SeasLog進行健康預警

預警的配置

[base]wait_analyz_log_path = /log/base_test[fork];是否開啟多線程 1開啟 0關閉fork_open = 1;線程個數fork_count = 3[warning]email[smtp_host] = smtp.163.comemail[smtp_port] = 25email[subject_pre] = 預警郵件 -email[smtp_user] = [e-mail][smtp_pwd] = seaslog#demoemail[mail_from] = [e-mail][mail_to] = [e-mail][mail_cc] = [e-mail][mail_bcc] =[analyz]; enum; SEASLOG_DEBUG      "debug"; SEASLOG_INFO       "info"; SEASLOG_NOTICE     "notice"; SEASLOG_WARNING    "warning"; SEASLOG_ERROR      "error"; SEASLOG_CRITICAL   "critical"; SEASLOG_ALERT      "alert"; SEASLOG_EMERGENCY  "emergency"test1[module] = test/bbtest1[level] = SEASLOG_ERRORtest1[bar] = 1test1[mail_to] = [e-mail]2[module] = 222test2[level] = SEASLOG_WARNINGtest3[module] = 333test3[level] = SEASLOG_CRITICALtest4[module] = 444test4[level] = SEASLOG_EMERGENCYtest5[module] = 555test5[level] = SEASLOG_DEBUG

crontab配置

;每天凌晨3點執行0 3 * * * /path/to/php /path/to/SeasLog/Analyzer/SeasLogAnalyzer.php

Demo:

<?php/** * @author [e-mail] * Date: 14-1-27 下午4:41 */  SeasLog::log(SEASLOG_ERROR,'this is a error test by ::log');SeasLog::debug('this is a {userName} debug',array('{userName}' => 'neeke'));SeasLog::info('this is a info log');SeasLog::notice('this is a notice log');SeasLog::warning('your {website} was down,please {action} it ASAP!',array('{website}' => 'github.com','{action}' => 'rboot'));SeasLog::error('a error log');SeasLog::critical('some thing was critical');SeasLog::alert('yes this is a {messageName}',array('{messageName}' => 'alertMSG'));SeasLog::emergency('Just now, the house next door was completely burnt out! {note}',array('{note}' => 'it`s a joke'));echo "\n";