PHP記錄和讀取JSON格式日誌文件
我們有時需要記錄用戶或者後端的某個操作事件的運行情況,可以使用後端語言如PHP將操作結果記錄到日誌文件中,方便測試和查找問題。尤其是這些在後端運行的而前端不能直接看到運行結果的,那麽就可以用日誌文件記錄下來,如果你經常跟一些接口開發如支付寶接口、微信卡券接口打交道的話,日誌記錄就必不可少了。
我們講的PHP記錄日誌,就是將日誌信息寫入到一個日誌文件中,區別於內存日誌。寫入日誌的流程是:打開日誌文件(如果不存在則新創建),然後將日誌內容追加到日誌文件的後面,最後關閉日誌文件。
本文中,我們將日誌內容以json個格式保存,方便必要時直接讀取。
PHP寫日誌文件
PHP寫日誌文件需要打開、寫入和關閉文件等操作,PHP有fopen(),fwrite()和fclose()三個函數與之對應,而另一個函數file_put_contents()它也能字符串寫入文件,其實這個函數實現了依次調用 fopen(),fwrite() 以及 fclose()。所以我們使用file_put_contents()非常簡潔。值得註意的是,往文件後面追加內容時需要帶上參數:FILE_APPEND。
實際運行中,我們有可能會遇到日誌文件超大的情況,所以我們設置一個最大值,當日誌文件大小超過這個最大值時,將此日誌文件備份好,然後重新生成一個新的日誌文件來記錄新的日誌內容。
在寫日誌前,我們將日誌內容進行json格式化,所以需要將內容轉化成JSON格式,然後寫入文件。當然你也可以不用json,或者換作別的工具程序(如日誌分析工具)可以閱讀的格式。總之,我們寫入的內容是方便必要時可以方便讀取。
function writeLog($filename,$msg){ $res = array(); $res[‘msg‘] = $msg; $res[‘logtime‘] = date("Y-m-d H:i:s",time()); //如果日誌文件超過了指定大小則備份日誌文件 if(file_exists($filename) && (abs(filesize($filename)) > 1024000)){ $newfilename = dirname($filename).‘/‘.time().‘-‘.basename($filename); rename($filename, $newfilename); } //如果是新建的日誌文件,去掉內容中的第一個字符逗號 if(file_exists($filename) && abs(filesize($filename))>0){ $content = ",".json_encode($res); }else{ $content = json_encode($res); } //往日誌文件內容後面追加日誌內容 file_put_contents($filename, $content, FILE_APPEND); }
PHP讀日誌文件
必要時,我們會讀取日誌內容進行分析,同樣我們使用PHP的file_get_contents()函數,直接將內容讀取,並且轉換成json格式,方便調用。
function readLog($filename){ if(file_exists($filename)){ $content = file_get_contents($filename); $json = json_decode(‘[‘.$content.‘]‘,true); }else{ $json = ‘{"msg":"The file does not exist."}‘; } return $json; }
日誌寫入和讀取類
寫入和讀取日誌的功能我們經常要用到,所以我將寫入和讀取功能整理成類,方便調用。
<?php /* * 日誌類 * 每天生成一個日誌文件,當文件超過指定大小則備份日誌文件並重新生成新的日誌文件 */ class Log { private $maxsize = 1024000; //最大文件大小1M //寫入日誌 public function writeLog($filename,$msg){ $res = array(); $res[‘msg‘] = $msg; $res[‘logtime‘] = date("Y-m-d H:i:s",time()); //如果日誌文件超過了指定大小則備份日誌文件 if(file_exists($filename) && (abs(filesize($filename)) > $this->maxsize)){ $newfilename = dirname($filename).‘/‘.time().‘-‘.basename($filename); rename($filename, $newfilename); } //如果是新建的日誌文件,去掉內容中的第一個字符逗號 if(file_exists($filename) && abs(filesize($filename))>0){ $content = ",".json_encode($res); }else{ $content = json_encode($res); } //往日誌文件內容後面追加日誌內容 file_put_contents($filename, $content, FILE_APPEND); } //讀取日誌 public function readLog($filename){ if(file_exists($filename)){ $content = file_get_contents($filename); $json = json_decode(‘[‘.$content.‘]‘,true); }else{ $json = ‘{"msg":"The file does not exist."}‘; } return $json; } } ?>
使用方法:
$filename = "logs/log_".date("Ymd",time()).".txt"; $msg = ‘寫入了日誌‘; $Log = new Log(); //實例化 $Log->writeLog($filename,$msg); //寫入日誌 $loglist = $Log->readLog($filename); //讀取日誌
源碼下載:http://xiazai.jb51.net/201607/yuanma/phplog(jb51.net).rar
PHP記錄和讀取JSON格式日誌文件