我们有时需要记录用户或者后端的某个操作事件的运行情况，可以使用后端语言如PHP将操作结果记录到日志文件中，方便测试和查找问题。尤其是这些在后端运行的而前端不能直接看到运行结果的，那么就可以用日志文件记录下来，如果你经常跟一些接口开发如支付宝接口、微信卡券接口打交道的话，日志记录就必不可少了。

我们讲的PHP记录日志，就是将日志信息写入到一个日志文件中，区别于内存日志。写入日志的流程是：打开日志文件（如果不存在则新创建），然后将日志内容追加到日志文件的后面，最后关闭日志文件。

本文中，我们将日志内容以json个格式保存，方便必要时直接读取。

PHP写日志文件

PHP写日志文件需要打开、写入和关闭文件等操作，PHP有fopen()，fwrite()和fclose()三个函数与之对应，而另一个函数file_put_contents()它也能字符串写入文件，其实这个函数实现了依次调用 fopen()，fwrite() 以及 fclose()。所以我们使用file_put_contents()非常简洁。值得注意的是，往文件后面追加内容时需要带上参数：FILE_APPEND。

实际运行中，我们有可能会遇到日志文件超大的情况，所以我们设置一个最大值，当日志文件大小超过这个最大值时，将此日志文件备份好，然后重新生成一个新的日志文件来记录新的日志内容。

在写日志前，我们将日志内容进行json格式化，所以需要将内容转化成JSON格式，然后写入文件。当然你也可以不用json，或者换作别的工具程序（如日志分析工具）可以阅读的格式。总之，我们写入的内容是方便必要时可以方便读取。

1. function writeLog($filename,$msg){ 
2.     $res = array(); 
3.     $res['msg'] = $msg; 
4.     $res['logtime'] = date("Y-m-d H:i:s",time()); 
5.  
6.     //如果日志文件超过了指定大小则备份日志文件 
7.     if(file_exists($filename) && (abs(filesize($filename)) > 1024000)){ 
8.         $newfilename = dirname($filename).'/'.time().'-'.basename($filename); 
9.         rename($filename, $newfilename); 
10.     } 
11.  
12.     //如果是新建的日志文件，去掉内容中的第一个字符逗号 
13.     if(file_exists($filename) && abs(filesize($filename))>0){ 
14.         $content = ",".json_encode($res); 
15.     }else{ 
16.         $content = json_encode($res); 
17.     } //phpfensi.com 
18.  
19.     //往日志文件内容后面追加日志内容 
20.     file_put_contents($filename, $content, FILE_APPEND); 
21. } 

PHP读日志文件

必要时，我们会读取日志内容进行分析，同样我们使用PHP的file_get_contents()函数，直接将内容读取，并且转换成json格式，方便调用。

1. function readLog($filename){ 
2.     if(file_exists($filename)){ 
3.         $content = file_get_contents($filename); 
4.         $json = json_decode('['.$content.']',true); 
5.     }else{ 
6.         $json = '{"msg":"The file does not exist."}'; 
7.     } 
8.     return $json; 
9. } 

日志写入和读取类

写入和读取日志的功能我们经常要用到，所以我将写入和读取功能整理成类，方便调用。

1. <?php  
2. /* 
3.  * 日志类 
4.  * 每天生成一个日志文件，当文件超过指定大小则备份日志文件并重新生成新的日志文件 
5. */ 
6. class Log { 
7.   
8.     private $maxsize = 1024000; //最大文件大小1M 
9.      
10.     //写入日志 
11.     public function writeLog($filename,$msg){ 
12.         $res = array(); 
13.         $res['msg'] = $msg; 
14.         $res['logtime'] = date("Y-m-d H:i:s",time()); 
15.   
16.         //如果日志文件超过了指定大小则备份日志文件 
17.         if(file_exists($filename) && (abs(filesize($filename)) > $this->maxsize)){ 
18.             $newfilename = dirname($filename).'/'.time().'-'.basename($filename); 
19.             rename($filename, $newfilename); 
20.         } 
21.   
22.         //如果是新建的日志文件，去掉内容中的第一个字符逗号 
23.         if(file_exists($filename) && abs(filesize($filename))>0){ 
24.             $content = ",".json_encode($res); 
25.         }else{ 
26.             $content = json_encode($res); 
27.         } 
28.   
29.         //往日志文件内容后面追加日志内容 
30.         file_put_contents($filename, $content, FILE_APPEND); 
31.     } 
32.   
33.   
34.     //读取日志 
35.     public function readLog($filename){ 
36.         if(file_exists($filename)){ 
37.             $content = file_get_contents($filename); 
38.             $json = json_decode('['.$content.']',true); 
39.         }else{ 
40.             $json = '{"msg":"The file does not exist."}'; 
41.         } 
42.         return $json; 
43.     } 
44. } 
45.  ?> 

使用方法：

1. $filename = "logs/log_".date("Ymd",time()).".txt"; 
2. $msg = '写入了日志'; 
3. $Log = new Log(); //实例化 
4. $Log->writeLog($filename,$msg); //写入日志 
5. $loglist = $Log->readLog($filename); //读取日志

Tags: 格式 文件 日志

分享到：