`

Aert_Log: 设计一个精简易用的日志

阅读更多

日志记录对于应用的维护特别是对于已部署到运行环境之后的应用调试都有着重要的意义。

 

对于一个应用的日志系统而言,首先必须得有一个日志对象,该对象负责记录日志信息。同时该信息可以输出到不同的位置,例如控制台,文件甚至网络中。对于信息的格式,则可以根据不同的需求,可以输出成普通文本,XML 或者 HTML 的格式。同时还需要对日志信息进行不同级别的分类,这样的好处是可以过滤冗余信息,只保留关键的日志。对于一个日志框架而言,日志对象必须是可配置的,它可以按照配置来输出到指定的目标,同时按照配置来决定输出的格式和决定何种级别以上的日志才能输出。

 

在我成为PHP程序员后,我使用过许多的PHP框架,也使用过太多大同小易的日志类,抑或者自己实现一个日志类也是非常简单的,譬如 这个这个

 

这些看起来都能够记录日志,但是 这真的就是我们需要的日志功能么?

 

接着我去问一个软件测试人员(非程序员),你理解的日志功能到底有哪些?

他给我的答案,大致如下:

 

  1. 记录信息: 能够在一个地方查看输出结果
  2. 分级输出: 能够过滤指定级别的日志记录
  3. 格式输出: 能够以不同的形式来输出,诸如 html,xml,txt等
  4. 报警提示: 错误并不能每次都能检测到,对于某些错误应该能够提醒应用维护人员

根据上述 4 条,其实 大部分框架中都基本实现了 1 - 3 这部分功能,比如

 

1. 记录信息到本地文件,SAE环境,等等

2. 过滤特定级别信息

3. 格式输出,大部分使用场景都是 txt 格式的,扩展其它样式应该也不难

 

对于 报警  这一项基本都没有什么体现,而这一点我思索之后觉得其实是很重要的一个环节,拿我们日常开发来讲,假设此场景: 客服童鞋反映 一个线上bug突然出现,请你赶紧解决,

 

我们的解决思路大概是这样: 根据客服童鞋给的bug一些诸如截图,访问地址之类的信息去重现这个bug,如果能够重现成功,那么恭喜你;但是大部分线上bug很难重现,或者说是在某些特定环境下才能重现;

 

此时 我们就会去查应用日志(如果你没有记录,嘿嘿,那你...),我们要从庞大的日志文件中去定位记录的信息(如果按大小进行了分割的话就有"且众多"), 看到这里你是否想到了"报警" 是个多么有用的手段啊,不管是发邮件还是sms,抑或微信等消息....虽然不是个银弹,但是可以节省我们好多时间啊

 

大概是三天前,我个人脑子发热,想搞一个在线幻灯片的应用,因为我实在是不会写好看的PPT,再加上看到了

impress.js 这个小东西,觉得我是不是可以一劳永逸的去解决这个坑爹问题,我可以使用熟悉的 markdown 语法,再加上简单的几个配置操作就能够搞出一个漂亮的PPT去做分享.如果你也有这方面的需求,可以大家一起探讨,当然如果你能给出一些资金来帮助我的话那就更好了,募捐地址

对于资助的童鞋,请留下亲的邮箱,上线之后给亲们高级会员的角色 ....

 

制定计划之后我就准备进行前期的骨架代码的构建,首先选一个开发框架吧,这么多,挑来挑去,说实话没有找到

几个合适的,最后选中3个: qeephp/yaf/ci. 折腾了一下午,还是没有下定使用哪个的原因,因为都有这个那个的问题,最后脑残去oschina去搜,结果看到了 SinglePHP  这个迷你框架,大概通读了下,发现这样的结构差不多才是我想要的简单框架,准备使用它,但是其很弱小,功能很不完善,就决定在其基础上就行修改,结果改来改去改到今天就变成了重造了一个轮子.

 

同步下进展情况,当前完成了如下功能:

目录结构如下:

 

 

框架代码都在Aert.core.php 文件中,加上注释一起目前有1500行不到

实现了一个基于MVC架构的面向移动互联网应用的微型PHP框架,当前完全实现了:

1. MVC 结构

 

2. 自定义错误&异常处理,自带的错误处理方便开发者定位错误原因,已实现PHP fatal 错误

3. ACL 权限控制: 实现了访问权限控制,实现了 角色资源控制

 

4. url路由设置: 实现了 正反向双解析功能的路由

 

## 路由配置信息:
# url 路由配置(key 路由名字, value 路由配置)
			'route_list' => array(
				'post_show' => array(
					'pattern' => 'post/{clz}/{id}-{name}.html',
			        'config'    => array(  
			            'clz'  => '[a-z][a-z_0-9]+',
						'id'    => '[0-9]+',				            
			            'name'  => '[a-z][a-z_\-0-9]+',  
			        ),  
			        'default'   => array(
			        	'controller'    => 'post',
			            'action'    => 'show',  
			            'clz'    => 'life',
			        ),      
				),
				
				'app_entry' => array(
					'pattern' => '{action}.html',
					'config'    => array(  
			            'action'  => '[a-z][a-z0-9]+',  
			        ),
					'default'   => array(
			        	'controller'    => 'application',  
			            'action'    => 'index',
			        ),
				),
				
				# 缺省配置
				'default' => array(
					'pattern' => '{controller}/{action}.html',
					'config'    => array(  
			           	'controller'  => '[a-z][a-z0-9]+',  
			            'action'  => '[a-z][a-z0-9]+',  
			        ),
					'default'   => array(  
			            'controller'    => 'application',
			            'action'    => 'index',
			        ),
				),
			),

## 测试反向url生成
		echo url('default','post_show',array(
			'id' => 456,
			'name' => 'ken-test-123',
			'clz' => 'java',
		));
		echo '<br>';
		echo url('default','default',array(
			'id' => 456,
			'name' => 'ken-test-123',
		));
		echo '<br>';
		echo url('backend','default',array(
			'action' => 456,
			'name' => 'ken-test-123',
		));

## 输出结果如下
/qart-dev/post/java/456-ken-test-123.html
/qart-dev/application/index.html?id=456&name=ken-test-123
/qart-dev/backend/application/456.html?name=ken-test-123

 

## 测试正向url解析

 

 

5. 应用挂载点支持: 以博客为例,我们经常要分成3个部分,比如 前台,后台,再比如多用户的话那么还要加上 用户中心. 对于这些划分,之前比如我们在使用 thinkphp/qeephp/yii/yaf等框架时我们总要考虑在站点根目录下要新建好几个入口文件或者建几个不同的目录.而且还要考虑一个实际问题: 我们如何去公用模型等库对象.

 

通过思索,我觉得这些能否不需要这么麻烦,我们就不能偷懒么,反正都是在一个域下,这些目录无非就是提现到url之上,此时我想到了在linux上使用mount命令时可以将其它的设备挂载到系统上,所以此处我引入了"挂载点"这个概念,我认为 譬如 前台/用户中心/后台/... 这些能否直接给挂载到一个根下面呢,假设应用的基准路径是

http://localhost/qart-dev/,把它影射成应用的根挂载点 '/', 通常我们都把前台作为应用的缺省访问地址,此处可以把 前台想成是 '/'; 而后台一般是 /admin/;用户中心一般是/usercenter/. 

 

而我们只需要拿到 pathinfo 之后,先去进行挂载点的匹配就能定位出访问地址究竟是要访问哪个模块....

 

这样我们就可以肆无忌惮的在配置文件中对非'/'模块的挂载点进行设置,比如按日期进行变化等等,而此处的修改并不会影响应用程序的代码结构

 

此时我们实际上是将多个入口文件进行了合并,只保留一个入口文件,但是此时又引入了一些新的问题,譬如:

  • 不同模块所处的开发进度不一样,有的已经上线了有的仍处于开发测试阶段,不同模块需要设置不同的错误提示级别和错误处理过程
  • 模块所需的用户主体不一样,比如前台/用户中心和管理后台其用户主体大多数都不一样
  • 模块的acl资源角色可能不一样
  • 模块的日志和路由都可能不一样,比如管理后台的日志就不要记录到前台的日志文件中

针对上述种种 ,我认为不同的模块之间可通过不同的配置项进行单独设置,比如不同的用户主体,不同的错误级别,不同的日志,路由,acl权限等等.

 

但是上升到整个应用的层面上来讲,模块的调用归根到底还是提现在url上,为此我将模块这个概念转化成了 "url命名空间",而url真正能映射到应用中的资源只存在 控制器/视图的代码上,也就是说 我们只需要对控制器文件以及视图文件进行划分即可,假设将控制器划分成 "url命名空间/控制器" 这种形式 ,是不是就能实现隔离呢,而那些模型类/代码库等文件是不是就可以通用呢.

 

我想是的,所以我就如此实践了,结果证明完全是可行的.定义一个命名空间最低需要如此设置即可

# 用于单元测试
		'testcase' => array(

			'mountpoint' => '/testcase/',

			# 错误处理
			'error.level' => E_ALL | E_STRICT,
			'error.exception' => 'ErrorHandler::sysHanException',
			'error.userlevel' 	=> 'ErrorHandler::sysHanUserlevel',
			'error.fatal' 	=> 'ErrorHandler::sysHanFatal',
			
			# 权限配置
			'authorized_default' => Aert_ACL::EVERYONE, # EVERYONE || NOBODY
			
			# url 路由配置(key 路由名字, value 路由配置)
			'route_list' => array(
				
				# 缺省配置				
				'default' => array(
					'pattern' => '{action}.html',
					'config'    => array(  
			            'action'  => '[a-z][a-z0-9]+',  
			        ),
					'default'   => array(
			        	'controller'    => 'application',  
			            'action'    => 'index',
			        ),
				),
			),
		),

 

 

6. 日志: 按开篇的日志讨论的结果进行了实现

 

 

class Aert_Log
{
    const TRACE = 1;
    const DEBUG = 2;
    const INFO  = 3;
    const WARN  = 4;
    const ERROR = 5;
    const FATAL = 6;
        
    private $enable = false;
    private $level;
        
    /**
     * 日志存储器
     * @var Aert_LogAppender
     */
    private $appender;
    
    /**
     * 日志存储器
     * @var Aert_LogAppender
     */
    private $alert;
    private $alertLevel;
    private $enableAlert = false;
        
    private static $levelNames = array(
        1 => 'TRACE',
        2 => 'DBEUG',
        3 => 'INFO',
        4 => 'WARN',
        5 => 'ERROR',
        6 => 'FATAL',
    );
	
    /**
     * 返回指定的日志服务对象实例
     *
     * @param string $name
     * @param array $config
     *
     * @return Aert_Log
     */
    static function instance($name, array $config=array())
    {
        static $instances = array();
        if (!isset($instances[$name]))
        {
            $instances[$name] = new self($config);
        }
        return $instances[$name];
    }
    
    private function __construct(array $config)
    {
        $this->level = intval(val($config, 'level', self::WARN));
        $this->enable = (bool) val($config ,'enable' ,TRUE);
        
        if ($this->enable)
        {
        	do {
	        	if ( empty($config['appender']) || empty($config['appender']['class']) )
		        {
		        	$this->enable = false;
		        	break;
		        }
		        $class = $config['appender']['class'];
		        $params = (array) val($config['appender'], 'config', NULL);
				
		        $this->appender = new $class($params);
		        
		        if ( !empty($config['alert']) || !empty($config['alert']['class']) )
		        {
		        	$this->enableAlert = TRUE;		        	
		        	$this->alertLevel = (int) val($config['alert'] ,'level' ,self::ERROR);
		        	
		        	$class = $config['alert']['class'];
		        	$params = (array) val($config['alert'], 'config', NULL);
		        	
		        	$this->alert = new $class($params);
		        }
		        
        	} while (false);
        }
        
    }
	
    function log($level, $msg)
    {
    	if (!$this->enable) return;
    	if ($this->enableAlert && ($level >= $this->alertLevel))
    	{
    		$this->alert($level, $msg);
    	}
    	if ($level < $this->level) return;
    	$this->appender->append(self::$levelNames[$level], $msg);
    }
    
    private function alert($level, $msg)
    {
    	$this->alert->alert(self::$levelNames[$level], $msg);
    }
}

/**
 * 日志存储器
 */
class Aert_LogAppender
{
	function __construct(array $config)
	{
		$this->init($config);	
	}
	
	protected function init(array $config)
	{
		
	}
	
	function append($level, $msg)
	{
		
	}
}

/**
 * 日志警报器
 */
class Aert_LogAlert
{
	function __construct(array $config)
	{
		$this->init($config);	
	}
	
	protected function init(array $config)
	{
		
	}
	
	function alert($level, $msg)
	{
		
	}
}

 以url命名空间 default 的配置为例

 

将日志的存储以及警报进行了分离,可以大大简化自定义日志处理的复杂度以及增强处理的多样性.比如可以单独实现File存储,SAE存储等,对报警器则可以实现控制台(一般是浏览器)输出,邮件,SMS,QQ,微信,SMS等多种.

 

此处给出 控制台(一般是浏览器)输出 以及 火狐插件FirePHP 的实现

<?php
/**
 * 日志警报器 -- Console
 * 
 * 监听指定错误级别,并直接打印到控制台
 */
class LogAlert_Console extends Aert_LogAlert
{
	function alert($level, $msg)
	{
		if (AERT_ISCLI)
		{
			fwrite(STDOUT, PHP_EOL . "[$level]: " . print_r($msg,true) . PHP_EOL);
		}
		else
		{
			if (is_string($msg))
			{
				echo "<BR />[$level]: " . print_r($msg,true);
			}
			else
			{
				dump($msg,"[{$level}]");					
			}				
		}		
	}
}

 

 

<?php
#{{{
app_import_file('/Lib/FirePHP.class.php');
#}}}

/**
 * 日志警报器 -- FirePHP
 * 
 * 监听指定错误级别,并通过火狐扩展 FirePHP 通知开发人员
 */
class LogAlert_FirePHP extends Aert_LogAlert
{
	function alert($level, $msg)
	{
		if (is_object($msg) && $msg instanceof TableRows)
		{
			/* @var $msg TableRows */
			$caption = $msg->getCaption();
			if (empty($caption)) $caption = $level;
			
			FirePHP::getInstance(true)->table($caption, $msg->combingRows());
			return;
		}
		
		switch ($level)
		{
			case 'TRACE':
				FirePHP::getInstance(true)->log($msg,$level);
				break;
			case 'DBEUG':
				FirePHP::getInstance(true)->log($msg,$level);				
				break;
			case 'INFO':
				FirePHP::getInstance(true)->info($msg);
				break;
			case 'WARN':
				FirePHP::getInstance(true)->warn($msg);
				break;
			case 'ERROR':
				FirePHP::getInstance(true)->error($msg);
				break;
			case 'FATAL':
				FirePHP::getInstance(true)->error($msg,$level);
				break;
		}
	}
}

 

 

本文大体能算完结了... 谢谢诸位的阅读,3q.

 

 

  • 大小: 16.7 KB
  • 大小: 5.1 KB
  • 大小: 41.6 KB
  • 大小: 21.8 KB
  • 大小: 24.6 KB
  • 大小: 14.8 KB
2
0
分享到:
评论
2 楼 vb2005xu 2014-04-23  
http://www.chinaz.com/program/2008/0614/31068.shtml  php 表网关
1 楼 vb2005xu 2014-04-23  
http://medoo.huoxr.com/doc.php 借鉴实现Aert_Db的工具集

相关推荐

    基于新的MDE插件创建eclipse项目_lpf1

    **MDE(Model Driven Engineering)**插件是一种用于支持模型驱动工程方法论的Eclipse插件,它能够帮助开发者通过模型来设计、实现和维护软件系统,提高开发效率及质量。 根据提供的信息,我们了解到获取新MDE插件...

    FreemodbusRTU在stm32上的移植分析.pdf

    在编译过程中,可能会出现undefined symbol __aeabi_aert错误,这个错误是因为MicroLib不支持aert()函数所致。解决这个错误的方法是,在target中钩掉USEMicroLIB编译选项。 四、移植ModbusRTU到stm32平台上 Modbus...

    FreemodbusRTU在stm32上的移植分析.docx

    为了方便测试,我们可以先实现第一个 eMBErrorCodeeMBRegInputCB 函数,来读取连续多个寄存器的值。例如,可以实现读取 GPIOA-GPIOG 的值。可以定义寄存器的起始地址和寄存器的数量,然后在 ...

    天然纤维增强聚合物复合材料,全球前5强生产商排名及市场份额.docx

    报告中提到的全球市场领导者包括Trex Company, Inc、The AZEK Company、Fiberon LLC、Avient Corporation (PolyOne)、Oldcastle Architectural (AERT)等。这些公司在2020年的市场份额总计约为26.0%,显示了行业内的...

    一个使用Androidstudio开发的校园通知APP

    一个使用AndroidStudio开发的校园通知APP,支持注册登录,支持聊天,后端技术:http get post 方法(分别有json数据格式和form数据格式),websocket长连接,用于接收消息,mqtt协议用于查看数据。

    基于粒子群的ieee30节点优化、配电网有功-无功优化 软件:Matlab+Matpowre 介绍:对配电网中有功-无功协调优化调度展开研究,通过对光伏电源、储能装置、无功电源和变压器分接头等设备协调

    基于粒子群的ieee30节点优化、配电网有功-无功优化 软件:Matlab+Matpowre 介绍:对配电网中有功-无功协调优化调度展开研究,通过对光伏电源、储能装置、无功电源和变压器分接头等设备协调控制,以实现光伏利用率最大、网络损耗最小、电压质量最优的综合优化目标。 采用粒子群算法寻求最优解,得到配电网的调控策略,从而制定合理的优化运行方案。 最后通过算例分析,说明其合理性。 Matpowre(需要Matpowre请安装不然会有错)

    C#自定义事件 2024年12月23日

    通过自定义事件来传值。此种方法适合于写驱动程序。进行数据采集。 对于一般的系统事件,是有两个参数的,一个是sender,一个是EventArgs,对于sender,个事件的触发者,一般指向的是一个控件,但是对于EventArgs,一般常用来传递鼠标位置等信息,下面就自定义事件传值就是通过EventArgs来实现。 通过EventArgs来实现传值,我们首先需要创建一个类,继承EventArgs,我们可以将需要传递的数据,直接在类里面定义成属性,这里以传递一个布尔(没有再最终的代码内使用)、一个浮点数,一个字符串为例,

    基于校园的互帮互助社交APP全部资料+详细文档+高分项目.zip

    【资源说明】 基于校园的互帮互助社交APP全部资料+详细文档+高分项目.zip 【备注】 1、该项目是个人高分项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(人工智能、通信工程、自动化、电子信息、物联网等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!

    Download usage

    Download usage

    基于高德地图的校园导航全部资料+详细文档+高分项目.zip

    【资源说明】 基于高德地图的校园导航全部资料+详细文档+高分项目.zip 【备注】 1、该项目是个人高分项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(人工智能、通信工程、自动化、电子信息、物联网等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!

    健康中国2030框架下智慧医药医疗博览会方案

    内容概要:本文介绍了 2020 京东健康智慧医药医疗博览会在湖南长沙举办的总体方案。该方案详细描述了展会的背景、目标、组织机构、展区规模和内容、主体活动、拟邀嘉宾及宣传媒体等内容。展会旨在展示互联网+医疗健康生态下的新技术、新产品和新方案,推动智慧医疗产业链的数据化、信息化和智慧化建设,为健康中国战略和健康湖南行动贡献力量。 适合人群:医疗行业的从业人员、智慧医疗技术开发者、政府相关部门、健康产业投资人等。 使用场景及目标:① 通过展会展示先进的医药医疗技术和产品,促进技术交流与合作;② 推动智慧医疗产业发展,助力健康中国战略和健康湖南行动的实施;③ 提高人民群众的健康水平和医疗服务质量。 其他说明:此次展会将设置十大展区,涵盖健康管理、智慧医院、精准医疗、智能穿戴、移动医疗系统、智能养老等多个方面,同期还将举办多场论坛和商务活动。

    qt开发类似于网盘的项目

    C/S架构,C++开发的,使用UDP协议

    2023-04-06-项目笔记 - 第三百五十六阶段 - 4.4.2.354全局变量的作用域-354 -2025.12.23

    2023-04-06-项目笔记-第三百五十六阶段-课前小分享_小分享1.坚持提交gitee 小分享2.作业中提交代码 小分享3.写代码注意代码风格 4.3.1变量的使用 4.4变量的作用域与生命周期 4.4.1局部变量的作用域 4.4.2全局变量的作用域 4.4.2.1全局变量的作用域_1 4.4.2.354局变量的作用域_354- 2024-12-23

    基于Bmob后台搭建的一块校园社区类APP,内置二手交易模块全部资料+详细文档+高分项目.zip

    【资源说明】 基于Bmob后台搭建的一块校园社区类APP,内置二手交易模块全部资料+详细文档+高分项目.zip 【备注】 1、该项目是个人高分项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(人工智能、通信工程、自动化、电子信息、物联网等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!

    高校学生求职就业平台(编号:24440246).zip

    高校学生求职就业平台(编号:24440246).zip

    Python与Pygame实现带特效的圣诞节场景模拟程序

    内容概要:本文详细介绍如何使用Python结合Pygame库制作一个充满圣诞气息的应用程序。该程序包括生成雪花、圣诞树以及闪烁星星的效果,并配以背景音乐以增加节日气氛。通过具体的代码示例,指导读者逐步构建这一有趣的项目。 适用人群:对于有兴趣探索Pygame图形库及游戏开发的基础开发者、编程初学者。 使用场景及目标:① 初步掌握Pygame的基本用法及其常见图形绘制方法;② 学习如何通过编程手段营造节日氛围;③ 作为个人项目或课堂作业的优秀实践。 其他说明:除了文中提供的基础功能外,鼓励读者在此基础上发挥创意,加入更多有趣的功能,比如动态改变场景中的物体、响应用户输入等,从而创造出独一无二的作品。

    计算机程序设计员三级(选择题)

    计算机程序设计员三级(选择题)

    基于Spring Boot的养老院管理系统的设计与实现_6575f5w2_223-wx(1).zip

    基于Spring Boot的养老院管理系统的设计与实现_6575f5w2_223-wx(1).zip

    数据结构排序算法:插入排序、希尔排序、冒泡排序及快速排序算法

    数据结构

    (42757812)0.96寸OLED显示屏STC8A8K64S4A12-IIC-例程

    内容来源于网络分享,如有侵权请联系我删除。另外如果没有积分的同学需要下载,请私信我。

Global site tag (gtag.js) - Google Analytics