readme.txt

													ActionInvoker调度框架简介及使用入门
													
								 [使用Notepad++/UtralEditor/EditPlus/ZendStudio等专业编辑器查看效果更佳]

一、框架结构：

	1、概览图
			|index.php
			|path__.php
			|
			|
			|core	|action	|Index.action.php
			|		|		|Test.action.php
			|		|
			|		|config	|const.php
			|		|		|define.php
			|		|		|shell.php
			|		|
			|		|filter	|Test.filter.php
			|		|       
			|		|entity	|Demo.entity.php
			|		|
			|		|lib	|base			|__include__.php
			|		|		|				|path__.php
			|		|		|				|env__.php
			|		|		|				|filter__.php
			|		|		|				|action__.php
项目名		|		|		|				|url__.php
			|		|		|				|init__.php
			|		|		|				
			|		|		|
			|		|		|ext			|其它自添加的库...
			|		|
			|		|
			|		|tpl	|default		|Action模板存放点
			|		|		|				
			|		|		|
			|		|		|other			|普通模板存放点
			|		|		
			|		|
			|		|setting|各种格式的
			|				|配置文件，
			|				|文件内容格式自定，
			|				|解析配置文件过程
			|				|也需要自己编写
			|
			|
			|res	|img
					|css
					|js
					|其它资源文件

	2、说明

		0)概念、名词解释：
			a、本框架的核心是“URL参数————Action调度”。
			b、入口：又称入口文件，是http请求后服务器首先调用的脚本，一般认为 /index.php就是入口。
				一般入口文件所在目录要配备一个path__.php文件，关于path__.php的作用及编写方法，见第一、2、 8) 条。
			c、Action方法：在Xxxx.action.php中定义的类方法，用static限定，调用形式：XxxxAction::shell();。
				模块：就是XxxxAction
				操作：就是XxxxAction中的类方法。
				默认模块：输入链接[ http://server.com/ItemName ]后被访问的模块。
				默认指令：输入链接[ http://server.com/ItemName ]后被访问的Action方法的名称。关于自定义默认指令，见 env__.php的DEFAULT_URL_SHELL
			d、指令（亦称URL SHELL、URL指令、shell）来源于链接[ http://server.com/ItemName/?xxx=param ]的param部分。
			e、param部分称为“URL全参数”，本项目要求的合法param的格式是：
						[指令] | [ 后续参数(集) = { [参数1|参数2|...|参数n-1] [ | id串={id1-id2-...-idn}] } ]
						例如：假设存在指令“dirdir”，不存其它指令“abc”
							dirdir|abcde|1-2-3-4-5		合法
							dirdir|abcde				合法
							dirdir|1-2-3-4-5			合法
							dirdir|1-2--4-5					非法
							dirdir						合法
							1-2-3-4						合法
							dirdir|							非法
							|dirdir							非法
							|dirdir|						非法
							dirdir|abcde|					非法
							|								非法
							||								非法
							|||								非法
							||||.....						非法
							abc								非法
							abc|abcd 						非法
							abc|1-2-3-4-5					非法
							abc|							非法
							|abc							非法
							|abc|							非法
							更多情况不一一列举，请依次类推。
			
					从以上的列举可以看出，指令必定存在于“URL全参数”的第一个单词。
			f、系统如果从URL解析出指令[URL SHELL]，那么就会继续寻找有没有对应的Action方法。
			g、如果一个指令能够成功调用某个Action方法，则存在与这个指令名称相同的Action方法。
					如：index指令对应index()方法。至于index()方法属于哪个Action，那就要看action__.php文件中怎么配置了。
			h、URL参数状态：其实就是对链接中param部分的种类划分。值：0 ~ 5。
				 * 0、空（长度0）
				 * 1、只有指令（长度1）
				 * 2、只有id串（长度1）
				 * 3、全满含id尾：有指令有作为id串的尾部
				 * 4、全满无id尾：有指令没有作为id串的尾部。也包括如“dirdir|fdsfdsfd|real|1-0-1”，最后一个参数可以认为已经不是id串了。
				 * 5、非法：
				 * 		长度为1时，非指令非id串；
				 * 		长度>1时，第一项非指令;
				 * 		长度等于1时id串去除第一个后还含有“零”项；
				 * 		“xxx|xxx|xxx|xxx”URL含有空串参数，即是否含有“||”或“空串|”或“|空串”；
			i、URL参数信息：通过UrlUtil::analyseUrlParam() @ url__.php获得。
				其数据格式：
				 * 		array (
				 * 			'status'=>	0~5 ,	//URL参数状态
				 * 			'shell'		=>	'URL命令/null',
				 * 			'params'	=>	array (
				 * 								被“|”分隔的参数集合
				 * 							),
				 * 			'ids'	=>	array(被“-”分割的id数组，不以“零”项开头，且不包含“零”项)
				 * 		);
		
		1)/core/action/ 目录用于放置业务相关的[模块——>操作]文件
			其中的IndexAction是默认的模块，内部的方法index()对应的指令是index.
			Action方法的传入参数：可以注意到，预配置的Action方法中，有名为$urlInfo的参数。
					该参数就是从URL中解析得到的参数信息，其参数状态有：0,1,3,4.最常见的参数状态是4。
					如何提取传入参数：从1开始，依次是 $urlInfo['params'][1]、$urlInfo['params'][2]、$urlInfo['params'][3]、...
					提取到的参数对应于：URL指令|param1|param2|param3|...
			将Action方法注册为URL指令：通过注册指令，就可以通过链接方式调用Action方法。
					本框架预注册的指令有：test,index,demo，对应于TestAction::test(),IndexAction::index(),IndexAction::demo()。
					注册方法：见ActionUtil::numOfShellArgs() @ aciton__.php及其注释部分。
			Action方法的调用代码：
				a、在某个模块中调用内部方法，可使用$this->方法名()。但是这种普通的调用方法将无法执行所绑定的过滤器。
					【关于过滤器，见第 一、2、5)条】
					如果要在调用方法前执行过滤器，则可使用：parent::__call($method, $vars)。
					其中，$method是方法名，$vars是传入的参数表构成的数组。
					例如：parent::__call('test', array($urlInfo));
				b、在模块外部调用模块方法：
					一般的代码是：$a = new XxxxAction(); $a -> 方法名();
					本框架推荐的代码是：ActionUtil::action('Action名称,如Index')->方法名();
					如果调用代码所处的位置也是在模块中，则调用代码还可写成：$this->action('Action名')->方法();或self::action('Action名')->方法();
			重新定义默认的模块及指令，见 DEFAULT_URL_SHELL @ env__.php 和 ActionUtil::numOfShellArgs() @ action__.php。
			另外的TestAction是示例模块，其方法test()已在ActionUtil::numOfShellArgs()中注册。
			
		2)/core/lib/ 目录存放基础库base和其他库
			基础库/core/lib/base/如下：
					环境配置文件					env__.php，
					过滤器支持文件				filter__.php，
					模块配置文件					action__.php，
					URL解析支持文件				url__.php，
					路径纠正支持文件				path__.php，
					系统初始化文件				init__.php，
					一次性包含常用库的文件		__include__.php
				a、env__.php配置常量和一些系统的惯例，如时区设定
				b、filter__.php提供过滤器支持。关于过滤器的说明和使用方法，见 【/core/filter/ 目录的说明】。
				c、action__.php配置所有Action的方法所对应的参数，以及配置如何调度Actions。详见源码注释。
				d、url__.php配置URL静态化、URL重写。从URL中分析参数信息等等。详见源码注释。
				e、init__.php初始化系统：
					=>先解析URL参数	=>尝试常规调度(Action) =>常规调度失败则尝试根据URL参数寻找模板文件并输出 =>匹配不到模板文件，则按404处理。
				f、__include__.php用于包含整个项目常用的文件。
					任何文件只要在其同目录下含有文件__path.php,并且已包含之，
					那么在包含这个文件之后，本文件所包含的文件就能被包含了。
			扩展库/core/lib/ext/：
				默认情况下，开发者应该把自行导入的库放置到此处。
				如果想把自己的库放到别处，则需要到env__.php配置USER_LIB_DIRS常量，具体配置方法见其注释。
		
		3)/core/setting/ 目录：存放各种格式的配置文件，其文件内容格式任意，但是需要自己编写解析配置文件的方法。
			作者已经有了一些类型配置文件的解析方法了，但是尚未整合到该框架中，请期待后续版本。
		
		4)/core/tpl/ 目录：存放模板输出文件的目录。
			    模板文件定义：用于输出到客户端的文件
			    模板的分类：按照用途，可以分为Action模板、普通模板。具体用途详见后续说明。
			    模板输出的底层实现方式：使用php的require_once语句。
			    模板参数支持：
			    	由XxxxAction的基类ActionUtil::getTplArgs() 提供带索引数组形式的参数，以供模板文件内脚本使用。
			    	由setTplArgs($tpl_args)方法设置参数，如果没什么参数可提供的，则可不写参数。
			a、Action模板：
				Ⅰ、特点：Action方法附属的模板文件，与方法同名，并由该Action方法独享。
				Ⅱ、命名规则：文件名等于方法名，后缀限定为.php。
				Ⅲ、存放位置：默认为/core/tpl/default/。如需自定义，见ACTION_TEMPLATE_DIR @ /core/lib/base/env__.php
						具体操作：先在core/tpl/default/新建名为Action名称的文件夹，
								   再在这个文件夹中新建与Action方法同名的模板文件，后缀名限定为.php。
								 如：IndexAction::index()的模板文件路径时：/core/tpl/default/Index/index.php
				Ⅳ、如何访问？不能通过链接直接访问，只能通过ActionUtil类方法tpl($tpl_args)实现间接访问。
					XxxxAction可以通过继承ActionUtil来得到tpl()方法的使用权。
				Ⅴ、参数支持：由基类ActionUtil::$tpl_args 提供带索引数组形式的参数，以供模板文件内脚本使用。
				Ⅵ、输出结果：如果找不到相应的模板文件，则不会输出任何内容，但tpl()方法会返回false作为标志。
							成功则返回true。开发者可以根据tpl()的返回值来判断是否输出成功。
				Ⅶ、用途：给业务方法配备专用的输出模板。
			b、普通模板：
				Ⅰ、特点：与Action模板不同，不从属于Action方法，可以在任何地方被调用。
				Ⅱ、命名规则：1、不含“-”；2、必须以.php为后缀名。
				Ⅲ、存放位置：默认为/core/tpl/other/。如需自定义，见 OTHER_TEMPLATE_DIR @ /core/lib/base/env__.php
					  可以要再细分目录存放模板文件，如果想通过链接访问到再深一层的文件，则需要用“-”代替“/”。
					 如：http://server.com/ItemName/?xxx=a-b-c 将默认访问到core/tpl/a/b/c.php。
				Ⅳ、如何访问？
					链接访问法：http://server.com/ItemName/?xxx=模板文件参数。
					代码调用法：require_once OTHER_TEMPLATE_DIR.'模板文件'。
				Ⅴ、标准的模板文件参数格式：a-b-c-...-z。
				Ⅵ、使用（“\”、“/”）混淆模板文件参数以保护路径。
	 				对于【'r_^-fds \  \--/gh'】之类的文件名参数，本系统可以将之解析为【r_^/fds/gh】
	 				（原参数中，有“-”和“--”，但是结果就有两条“/”。至于原参数中的“\\”和“/”，将被清除）。
	 				继续对【'r_^-fds \  \--/gh'】进行URL编码，可以得到【r_%5E-fds%20%5C%20%20%5C--%2Fgh】。
				Ⅶ、设置模板参数：
					如果使用【代码调用法】：则可以在调用之前，先执行XxxxAction::setTplArgs($tpl_args)以向模板文件提供参数。
					如果使用【链接访问法】：则无法设置参数。链接访问法通常用于不需要参数的页面。
				Ⅷ、输出结果：如果找不到模板，则按404处理。
				Ⅸ、用途：如果多个业务需要共享一个页面，则可以使用普通模板。
		
		5)/core/filter/ 目录：存放XxxxFilter.class.php。这个目录涉及到过滤器。
			a、过滤器：执行某过程之前需要执行的操作。
			b、内置过滤器：框架内置的 【模块单过滤器】，其实就是一个接口Filter，内设方法doFilter()，用于在进入Action模块前的过滤。
			c、单过滤器：如果某个过程仅需要一个过滤器，那么这个过滤器就构成了单过滤器。
			d、过滤器链：如果某个过程需要多个过滤器，那么这些过滤器就构成了过滤器链。
			e、过滤器分类：
				在本框架中，过滤器按过滤类型分为两种：Action模块过滤器、Action操作[方法]过滤器；
				再按过滤层次还可分为：单过滤器、过滤器链。
			f、过滤器群组：存储多种过程各自需要的单过滤器或过滤器链的单位。
				一般地，将属于同一个XxxxAction的所有模块过滤器和方法过滤器  归并到  同一个过滤器群组中。
				自然而然，这个存储单位将使用XxxxFilter.class.php存储。
				只要定义了XxxxFilter或XxxxAction实现了Filter接口，那么XxxxAction将自动绑定过滤器。
			g、使用过滤器详解：
				 * 1、如果仅需要————单个Action模块过滤器，就不需要定义高级过滤器 XxxxFilter，仅需实现Filter接口。
				 * 	格式如：
				 * 			class XxxxAction implements Filter{
				 *	 			public function doFilter(){
				 * 					//实现系统内置的模块单过滤器
				 * 				}
				 * 			}
				 * 2、如果需要在进入Action模块之前设置多个过滤器，那么这里就可以用到XxxxFilter了。
				 * 	过滤器群组XxxxFilter的定义格式：
				 * 		class XxxxFilter {
				 * 			public function doFilter_1(){
				 * 				//模块过滤器1
				 * 			}
				 * 			public function doFilter_2(){
				 * 				//模块过滤器2
				 * 			}
				 * 				... ...
				 * 		}
				 * 	  执行过滤器的顺序将是：doFilter_1(), doFilter_2(), ...
				 * 	 如果XxxxAction还实现了Filter接口的doFilter()方法，则会先执行doFilter()，再执行doFilter_1(), doFilter_2(), ...
				 *   建议：如果是定义多个模块过滤器，就不要使用框架内置的【模块单过滤器Filter】，以确保代码的可读性。
				 * 3、如果Action模块中的操作[方法]也需要过滤器，则可以在XxxxFilter()定义专门过滤Action操作的方法，方法名与Action方法同名
				 * 	格式如：
				 * 		class XxxxFilter {
				 * 			public function Aaaa(){
				 * 				//XxxxAction::Aaaa()方法对应的过滤器
				 * 			}
				 * 		}
				 *     如果XxxxAction::Aaaa()方法需要多个过滤器，则可以这样定义：
				 * 		class XxxxFilter {
				 * 			public function Aaaa_1(){
				 * 				//XxxxAction::Aaaa()方法对应的过滤器
				 * 			}
				 * 			public function Aaaa_2(){
				 * 				//XxxxAction::Aaaa()方法对应的过滤器
				 * 			}
				 * 			public function Aaaa_3(){
				 * 				//XxxxAction::Aaaa()方法对应的过滤器
				 * 			}
				 * 				... ...
				 * 		}
				 * 		执行过滤器的顺序将是：Aaaa_1(), Aaaa_2(), Aaaa_3(), ...
				 * 		如果Aaaa()过滤方法也存在，则会先执行Aaaa()，在执行Aaaa_1(), Aaaa_2(), Aaaa_3(), ...
				 * 	      建议：如果是定义多个方法过滤器，就不要再使用与Action方法同名的过滤方法，以确保代码的可读性。
				 */
			h、重新定制过滤器目录：见 FILTER_DIR @ /core/lib/base/env__.php
			
		6)/res/ 目录：存放js,css,img等资源文件。
			常规使用方法：可以自行定义常量以方便导入。如定义js目录为JS_DIR，在页面中使用<?=APPROOT.JS_DIR.'具体JS' ?>完成调用。
					对于一些频繁调用的文件，如jquery.js，则可进一步定义常量JQUERY_PATH为APPROOT.'res/js/jquery.js'。
		
		7)/index.php	一般会作为项目的入口。
			脚本固定执行流程如下：
				添加路径纠错支持
				包含框架
				完毕。
			代码：
				----------------------------------------------------------------------------------------------------------------------
				<?php
				/**
				 * 项目默认入口
				 */
				require_once 'path__.php';	//路径纠错支持
				require_once APPROOT.'core/lib/base/__include__.php';	//一次性包含常用库和所有Action
				/*
				 * 以上两行代码已经完成了框架的初始化，后面也不用添加什么代码了，写了也没有用，执行不到的。
				 * 要写业务处理，就定义XxxxAction；
				 * 要给业务加上过滤器，就直接让XxxxAction实现Filter接口或定义过滤器群组XxxxFilter
				 * 要显示页面，使用模板输出。
				 */
				?>
				----------------------------------------------------------------------------------------------------------------------
			如果需要定制其它入口文件，则新入口文件内的代码也和/index.php的一样，
			并要根据入口文件的目录层次，为其配备一个合适的path__.php文件，详见第一、2、8）条。
			
		8) path__.php  路径纠正支持文件
			a、作用：该文件中的APPROOT常量可以解决文件多重包含时产生的路径错乱问题。
			b、编写方法：
					<?php
					defined('APPROOT') or define('APPROOT','路径值');
					?>
			c、什么是路径值（APPROOT）？
				路径值指的是 项目根目录相对于path__.php的目录，如（''、'../'、'../../'等等）。
				如：
					/path__.php位于项目根目录，应配置的值为  './';
					/core/path__.php位于第一层目录，所以配置的值为 '../';
					/core/lib/path__.php位于第二层目录，所以配置的值为 '../../';
					/core/lib/base/path__.php位于第三层目录，所以配置的值为 '../../../';
			d、何时需要用到path__.php？
				凡是需要包含其它文件的脚本，都需要包含path__.php。【require_once 'path__.php';】
				那么，入口文件就要用到path__.php。
				
		9) APPROOT 常量
			a、其含义见第 8) 条。
			b、使用APPROOT包含文件的格式【require_once APPROOT.'路径串';】。
				要求路径串从项目根目录为起点，如：
				require_once APPROOT.'core/lib/base/__include__.php';
				
		10)	/core/entity/ 目录：存放实体类文件。例如Demo.entity.php
		
		11) /core/config/ 目录：存放开发者自定义常量、URL自定义指令等等。

二、使用入门

	1、将ActionInvoker文件夹提取到站点根目录，文件夹名称改为自己的项目名称。
	
	2、在/core/lib/base/env__.php配置自己系统中需要的常量和惯例（如时区设定）。
		需要重点配置的常量是：ENABLE_URL_REWRITE，其它自便。详见注释。
	3、查看默认的Action及操作。
		本项目已经预先在env__.php中定义了常量DEFAULT_URL_SHELL等于“Index-index”，对应IndexAction::index()。
		且在action__.php中的ActionUtil::numOfShellArgs()预配置的Index->index()参数个数为0.
		直接在浏览器测试类似以下链接：
			a、http://server.com/ItemName
			b、http://server.com/ItemName/?xxx=index
		就可以看到欢迎页。
		
	4、如果要添加自己的功能，则可以自行添加模块XxxxAction.class.php到/core/action/中，
		例如 添加文件模块FileAction，并在其中添加[显示目录内容]的方法listfile()。具体步骤如下：
			a、新建/core/action/File.action.php，代码参考Index.action.php
			b、在/core/lib/base/action__.php的ActionUtil::numOfShellArgs()中注册listfile()方法，并指定所需参数个数。
				这里的参数个数 不  是定义function时的参数表的参数个数，而是URL参数信息中count($urlInfo['params'])的值。
				【注：$urlInfo = UrlUtil::analyseUrlParam($_REQUEST);	//见core/lib/base/url__.php】
			c、测试链接：
				如果参数个数为0————http://server.com/ItemName/?xxx=listfile
				如果参数个数大于0————http://server.com/ItemName/?xxx=listfile|后续参数(集)
				
	5、如果需要将自己添加的功能设置为默认功能，只需要配置 DEFAULT_URL_SHELL  @  /core/lib/action__.php
		默认值的格式：Action名称-方法名，如：define('DEFAULT_URL_SHELL','File-listfile');
		注意：所配置的默认功能必须存在。
		
	6、如果需要导入其它库，只需要把库文件放置到/core/lib/ext/ 目录中，可以在其中再设定子目录存放。
		放置完毕后，系统将会自动包含其内所有层次目录的*.php文件。
		如果需要把自定义库文件放置到别处，则需要配置USER_LIB_DIR  @  /core/lib/base/env__.php
	
	7、简单输出页面：
		a、使用Action模板：
			将需要输出的Action页面放到/core/tpl/default/目录（如需改变目录，见ACTION_TEMPLATE_DIR @ /core/lib/base/env__.php）
			本框架已预定义了IndexAction::index()对应的模板，位于/core/tpl/default/Index/index.php。
			并在IndexAction::index()中使用了模板输出方法：self::tpl();
			预配置的模板将输出的内容是 本框架的欢迎页。
		b、使用普通模板：
			将需要输出的自由页面放到/core/tpl/other/目录（如需改变目录，见OTHER_TEMPLATE_DIR @ /core/lib/base/env__.php）
			本框架已预定义了普通模板/core/tpl/other/othertest.php。
			并在TestAction::test()方法中给出了测试代码。也可以通过链接来测试。
			链接访问方法：http://server.com/ItemName/?xxx=模板文件参数。（详见 一、2、(4) 条）			
	
	8、简单使用过滤器：
		本框架通过让TestAction模块实现Filter接口，从而绑定了内置的单模块过滤器Filter::doFilter()。
		通过定义过滤器群组TestFilter，从而使TestAction模块绑定了TestFilter::doFilter_*()过滤器链，
			也使TestAction::test()方法绑定过滤器TestFilter::test(),TestFilter_test_*()过滤器链。
		测试预置过滤器：执行IndexAction::demo	()方法即可。
			测试链接：http://server.com/ItemName/?xxx=demo

	9、强烈要求：不要用Windows自带的记事本编辑本框架的源代码，否则会由于UTF-8与GBK编码的混杂问题，导致IE9加载页面出错。
			
三、版本变更日志

	2013-7-29
		【
		初版：支持URL分析和Action调度
		】
	
	2013-7-30
		【
		加入自动包含库文件和Action的支持，嵌入使用向导到首页
		】
	
	2013-7-31
		【
		加入模板输出支持、
		
		非法参数和无效模板的404处理，
		
		准备加入过滤器支持（实现Filter接口以拦截进入Action模块的数据流）
		】
	
	2013-8-4
		【
		1、扩充模板输出能力，可以分为Action模板和普通模板两类；
		
		2、对无法访问到的脚本拦截，需要服务器支持URL重写；
		
		3、加入过滤器支持，支持单过滤器和过滤器链，
		
		   可以为模块专门定制一个过滤器群组
		】
		
	2013-12-5 
		添加config目录配置支持，至此，开发者将可在别处定义常量，而不用直接编辑env__.php。
		但对于框架级的常量，还是要回到env__.php中修改。
	
	2013-12-7
		添加entity目录配置支持，至此，开发者将可以定义自己的实体类
		简化了Action和Filter文件的名称。
		
	2013-12-8
		将URL指令和对应参数个数的配置从/core/lib/base/action__.php转移到/core/config/目录下的任意文件中，
		只要在这个位置的任意一个文件中定义类“AiUrlShell”即可，具体参考/core/config/urlshell.php

	2013-12-9 
		1、修正了XxxxFilter中定义的doFilter_x()  模块级过滤方法无法被执行到的BUG。
		2、发现了url参数的ids项的值不能超过2147483647（ids项被强制转换成了int类型）
			例如：
			http://localhost:8080/php/ActionInvoker/?xxx=demo|123121561651
			所传的第一个后续参数为：“123121561651”
			那么得到的url参数信息为：
			Array ( [status] => 3 [shell] => demo [params] => Array ( [0] => demo [1] => 123121561651 ) [ids] => Array ( [0] => 2147483647 ) ) 
			此情况不予处理，使用时请多加注意。
		3、发现了 /core/tpl/othertest/ 目录内的普通模板访问链接方式除了可用“-”隔开以外，还可用“/”或“\”
			例如：
			http://localhost:8080/ActionInvoker/?xxx=a-othertest
			可改为
			http://localhost:8080/ActionInvoker/?xxx=a/othertest
			或
			http://localhost:8080/ActionInvoker/?xxx=a\othertest
			对此情况，不予处理。并支持此情况继续存在，希望使用者可以灵活运用该特性。
		4、发现部分编写的页面没有以下声明时，在IE9模式下将无法正常加载。
			<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
			<html xmlns="http://www.w3.org/1999/xhtml">
		        因此建议，每个页面要有这些声明，以提高兼容性。
	
	2013-12-10 
		1、在“page”指令对应的页面中新增URL指令及参数测试功能，可以通过输入的信息实时测试模块。
		2、添加了全局过滤器支持。
			详见：
			GLOBAL_FILTER_NAME @ /core/lib/base/env__.php
			eval(GLOBAL_FILTER_NAME.'::doFilter($urlInfo);'); @ /core/lib/base/init__.php
			class GLOBALFILTER @ /core/filter/GLOBALFILTER.filter.php 
	
	2013-12-12 
		1、添加新的模块指令测试页面，其指令为“shelltest”，以方便开发人员直观地测试自己的模块功能。
			使用方法：
				根据页面中的提示，左边输入URL指令，右边输入参数（多个参数用“|”分开），下方的方框即显示访问结果。
				如果URL指令所需参数个数为零，则要清空右边的输入域。
			注意：shelltest指令对应的测试页将在后续的某个版本中取代“page”指令所指页面。

	2013-12-15至17
		 1、在/core/lib/exe/ 目录添加 [ mysql扩展 ] ，支持增、删、改实体。
		 2、修改/core/lib/base/init__.php，就此新增了全局过滤器链的支持。
		 	全局过滤链的使用方法类似于XxxxAction的过滤器。
		 	详见：
		 		GLOBAL_FILTER_NAME @ /core/lib/base/env__.php
		 		FILTER_DIR @ /core/lib/base/env__.php
		 		%FILTER_DIR% / %GLOBAL_FILTER_NAME% . filter.php
	
	2013-12-18
		1、在  [ mysql扩展 ] 中，添加了AiMySQLCondition.class.php，支持单个SQL条件的对象化，以配合MySQL查询。

	2013-12-19
		1、在  [ mysql扩展 ] 中，添加了AiMySQLCombination、AiMySQLOrderBy类，使SQL条件子句和排序子句规范化。
		2、在  [ mysql扩展 ]的实体查询中，支持条件查询、结果集游标范围指定、条件组合方式有限指定。
			已实现：查询条件——》结果集——》严格的类型转换——》正确对象的集合
	
	2013-12-20
		1、为 [ MySQL扩展 ] 提供第二种种查询支持：任意SQL查询。
		
	2013-12-21
		关于过滤器有效性的说明
			Action方法的过滤器的有效性由以下因素决定
				Action方法的访问修饰符(public、protected)，
				对应的过滤器，
				访问Action的方式
			现有某Action方法：urlshell()。作以下规定：
			---------------------------------------------
			if ( 以URL方式访问（http://yourserver:port/project/?xxx=urlshell） ){
				if ( 有定义对应的XxxFilter且有过滤器urlshell() ){
					if ( Action方法无访问修饰符 )
						【过滤器有效】;
					else if( Action方法以public修饰 )
						【过滤器有效】;
					else if( Action方法以protected修饰 )
						【过滤器有效】;
					else if( Action方法以private修饰 )
						【过滤器 无 效】且Action方法无法执行;
				}
				else if ( 没有对应的过滤器方法urlshell()或urlshell_*() ){
					if ( Action方法以public修饰  || Action方法以protected修饰  || Action方法无访问修饰符 )
						【无过滤功能】;
					else if( Action方法以private修饰 )
						【无过滤功能】且Action方法无法执行;
				}
			}
			else if( 以代码调用方式访问（ActionUtil::action('Xxxx')->urlshell();） ){
				if ( 有定义对应的XxxFilter且有过滤器urlshell() ){
					if ( Action方法无访问修饰符 )
						【过滤器 无 效】;
					else if( Action方法以public修饰 )
						【过滤器 无 效】;
					else if( Action方法以protected修饰 )
						【过滤器有效】;
					else if( Action方法以private修饰 )
						【过滤器 无 效】且Action方法无法执行;
				}
				else if ( 没有对应的过滤器方法urlshell()或urlshell_*() ){
					if ( Action方法以public修饰  || Action方法以protected修饰  || Action方法无访问修饰符 )
						【无过滤功能】;
					else if( Action方法以private修饰 )
						【无过滤功能】且Action方法无法执行;
				}
			}
			----------------------------------------------
			综上所述，凡是设置了过滤器的Action方法，
				如果设置为public或空，则仅在URL访问时会执行过滤器；
				如果设置为protected，则在URL访问或代码调用时都会执行过滤器；
				如果设置为private，则无论怎么访问，过滤器都是无效的。
		强烈建议：
			凡是需要过滤器的Action方法，都修饰为protected。
			对于protected，顾名思义，就是受过滤器保护的意思。
	
	2013-12-22
		在/core/config/目录添加了附加过滤规则（AFR），文件名为filtermap.php。
		在该文件中，可以配置需要或不需要配置全局过滤器的模块或指令。
		原理详见FilterUtil::globalFilter() @ /core/lib/base/filter__.php 和 init__.php
		
	2014-1-7
		1、[mysql扩展]开始支持数据表前缀，例如fm_xxx表与xxx对象对应。
		2、关于配置文件中一个值的说明
			值：AiAdditionalFilterMapRule::$elsePrior @ /core/config/filtermap.php
			说明：该值设定后，还有另外一种效果，即：
			* 	当为true时，如果某指令（如index）既需要又不需要全局过滤器，则视为需要全局过滤器
			* 	当为false时，如果某指令（如index）既需要又不需要全局过滤器，则视为 不 需要全局过滤器
	
	2014-1-29
		1、添加[FTP扩展]，目录ftp
			支持
				单文件全新上传、
				单文件断点上传、
				单文件全新下载、
				单文件断点下载、
				单文件改名（目录层次不改变为前提）、
				单目录改名（目录层次不改变为前提）、
				列出指定远程目录内的所有文件和目录明细。
			见AiFtp.class.php。
			支持FTP状态码反馈，见AiFtpStatus.class.php
		2、添加[FTP扩展]对应的测试Block，位于ftp_test()@HelpAction
		
		
		
		
		
		
		中间空了很多，需要补充回来，请查看历史各个版本的change.txt
		
		
		
		
		
	2014-4-13
		1、修正[mysql扩展]中mysql.php第109~110行，添加了以下语句：
				if(false===$value) $value='false';//如果字段为布尔假，则用无引号的false
				if(true===$value) $value='true';//如果字段为布尔真，则用无引号的true
				
			修正了插入bool数值到SQL语句导致语法不正常的BUG（布尔值处留空，即两个逗号之间为空）。
		
	

	2014-05-17

		0、版本号暂时更改为OpenAI[1.0.0]，内部版本号依旧为内部版本号ActionInvoker[1.9.8]。

		1、ActionInvoker将进入面向2.0的过渡阶段，目录结构为一个公共、多个成员。
		
		2、[AiFtp][AiMySQL]转移至公共目录public。
		
		3、新增[AiSQL]外挂SQL语句支持。
		
		4、新增core/lib/util/TableUtil.class.php，其内部分成员方法更安全可靠，将可替代AiMySQL的部分成员方法。
		
		5、新增core/lib/util/OrekiUtil.class.php，内有少量常用方法。
		
		6、新增AI前端配套插件AiForm.js，详见public/res/js/Ai/AiForm.js。
			使用方法详见：public/core/tpl/other/ai/widget.php。

		7、指定public目录的首页与说明文档关联，指定成员目录的首页与指令测试页面shelltest关联。
		
		8、public目录的启动脚本位于其目录外层，而成员目录的启动脚本位于其目录内第一层。
			项目根目录中index.php所指定的PUBLIC_DIR_NAME，将指定作为公用的目录；
			其它成员目录中的index.php所指定的PUBLIC_DIR_NAME，将指定其从属的公共目录。


	2014-05-18
	
		1、公共目录的默认名称由public更改为leader，如需自定义，见根目录index.php配置。
		
		2、成员目录的默认名称由memberX更改为hypotaxis，如需自定义，见hypotaxis/index.php配置。
		
		3、精简成员目录中base库的文件，将以leader目录的base库为准。