开源微博系统Xweibo的一些主要函数注释_PHP_编程开发_程序员俱乐部

中国优秀的程序员网站程序员频道CXYCLUB技术地图
热搜:
更多>>
 
您所在的位置: 程序员俱乐部 > 编程开发 > PHP > 开源微博系统Xweibo的一些主要函数注释

开源微博系统Xweibo的一些主要函数注释

 2010/12/25 0:02:23  liomao  http://liomao.javaeye.com  我要评论(0)
  • 摘要:D:\ProgramFiles\Apache\htdocs\codeconfig.php//配置些全局变量,系统版本等D:\ProgramFiles\Apache\htdocs\code\applicationinit.php//框架初始化文件cfg.php//框架配置文件,包括各个功能块的目录路径compat.php//框架兼容类,包括定义给个function。core.php//框架核心文件,classAPP{}D
  • 标签:函数 开源 微博 注释
D:\Program Files\Apache\htdocs\code
	config.php	//配置些全局变量,系统版本等




D:\Program Files\Apache\htdocs\code\application
	init.php	//框架初始化文件
	cfg.php	//框架配置文件,包括各个功能块的目录路径
	compat.php	//框架兼容类,包括定义给个function。
	core.php	//框架核心文件,class APP{}


D:\Program Files\Apache\htdocs\code\sae_install
	index.php	//

这是一个专属于广州大学华软软件学院的微博,借助于新浪微博系统部署在SAE上。欢迎大家访问。 这里有华软学子认证,有和华软想关的话题,这里有你更精彩!!

	/**
	 * APP::request();	处理用户请求
	 * @param $halt		执行完请求后是否退出
	 * @return 无返回值
	 */

	/**
	 * APP::getRequestRoute();	从当前请求中取得模块路由信息
	 * @param $is_acc			是否以数组的形式返回
	 * @return  requestRoute
	 */

	/**
	 * APP::addPreAction($doRoute, $type, $args=false);
	 * 此方法必须在 APP::init();之前执行
	 * @param $doRoute		模块路由,如 demo/index.show
	 * @param $type			模块类型,可选值为: m , f , c ; 分别表示 模块 函数 和 类库
	 * @param $args			模块所需要的参数,统一用数据传递,$type 为 m 时无效
	 * @param $except		例外模块,在这些模块中 将不执行此预处理程序 默认为空 可以是数组或者字符串
	 * @return 无返回值
	 */

	/**
	 * APP::mkModuleUrl($mRoute, $qData=false, $entry=false);
	 * 根据模块路由,query 数据 ,入口程序,生成URL,
	 * @param $mRoute		模块路由,如 demo/index.show
	 * @param $qData		添加在URL后面的参数,可以是数组或者字符串,
	 * 						如  array('a'=>'a_var') 或者  "a=a_var&b=b_var"
	 * @param $entry		入口程序名,默认获取当前入口程序,如: index.php admin.php
	 * @return 生成的URL
	 */

/// 数据交互组件的快捷访问方法 调用函数 dsMgr::call, 返回标准返回值结构,可自行处理错误
function DR() {


	/**
	 * V($vRoute,$def_v=NULL);
	 * APP:V($vRoute,$def_v=NULL);
	 * 获取还原后的  $_GET ,$_POST , $_FILES $_COOKIE $_REQUEST $_SERVER $_ENV
	 * 同名全局函数: V($vRoute,$def_v=NULL);
	 * @param $vRoute	变量路由,规则为:“<第一个字母>[:变量索引/[变量索引]]
	 * 					例:	V('G:TEST/BB'); 表示获取 $_GET['TEST']['BB']
	 * 						V('p'); 		表示获取 $_POST
	 * 						V('c:var_name');表示获取 $_COOKIE['var_name']
	 * @param $def_v
	 * @return unknown_type
	 */

	/**
	 * APP::redirect($mRoute,$type=1);
	 * 重定向 并退出程序
	 * @param $mRoute
	 * @param $type 	1 : 默认 , 内部模块跳转 ,2 : 给定模块路由,通过浏览器跳转 ,3 : 给定URL  ,4 : 给定URL,用JS跳
	 * @return 无返回值
	 */

	/**
	 * APP::F($fRoute);
	 * 执行 $fRoute 指定的函数 第二个以及以后的参数 将传递给此函数
	 * 例:APP::F('test.func',1,2); 表示执行  func(1,2);
	 * @param $fRoute 函数路由,规则与模块规则一样
	 * @return 函数执行结果
	 */

	/**
	 * APP::O($oRoute);
	 * 根据类路由 和 类初始化参数获取一个单例
	 * 第二个以及以后的参数 将传递给类的构造函数
	 * 如: APP::O('test/classname','a','b'); 实例化时执行的是 new classname('a','b');
	 * @param $oRoute 类路由,规则与模块规则一样
	 * @return 类实例
	 */

	/**
	 * APP::N($oRoute);
	 * 根据类路由 和 类初始化参数获取一个类实例
	 * 第二个以及以后的参数 将传递给类的构造函数
	 * 如: APP::N('test/classname','a','b'); 实例化时执行的是 new classname('a','b');
	 * @param $oRoute 类路由,规则与模块规则一样
	 * @return 类实例
	 */

	/**
	 * APP::M($mRoute);
	 * 执行一个模块
	 * @param $mRoute
	 * @return no nreturn
	 */

	/**
	 * APP::L($k);
	 * 根据语言索引返回信息信息
	 * 如果存在二个以上的参数,将以语言信息为格式 返回格式化后的字符串
	 * 如:APP::L($k,'a','b');
	 * 假设语言信息数据为 $_LANG,上例将返回 sprintf($_LANG[$k],'a','b');
	 * @param $k
	 * @return 格式化后的语言信息
	 */

	/**
	 * APP::importLang($lRoute);
	 * 导入一个语言信息文件
	 * @param $lRoute	语言信息路由 规则与模块路由一样
	 * @return 成功 true 失败 false;
	 */

	/**
	 * APP::functionFile($fRoute);
	 * 根据函数路由取得文件路径
	 * @param $fRoute	函数路由
	 * @return 函数文件路径
	 */

	/**
	 * APP::classFile($fRoute);
	 * 根据类路由取得文件路径
	 * @param $fRoute	类路由
	 * @return 类文件路径
	 */

	 * APP::moduleFile($fRoute);
	 * 根据模块路由取得文件路径
	 * @param $fRoute	模块路由
	 * @return 模块文件路径
	 */

	/**
	 * APP::tplFile($fRoute,$baseSkin=true);
	 * 根据模板路由取得文件路径
	 * @param $fRoute	模板路由
	 * @param $baseSkin	模板基准目录选项,默认为 true ,将使用系统配置的皮肤目录
	 * @return 模板文件路径
	 */

	/**
	 * APP::comFile($fRoute);
	 * 根据数据组件的路由取得文件路径
	 * @param $fRoute	数据组件的路由
	 * @return 文件路径
	 */
	
	/**
	 * APP::adpFile($name,$type);
	 * 根据适配器的名称和类型取得文件路径
	 * @param $name	适配器名称如: db http cache io 等
	 * @param $name	适配器类型如: db 可能的类型有: mysql access mssql 等
	 * @return 模板文件路径
	 */

	/**
	 * APP::ADP ($name,$is_single=true,$cfg=false);
	 * 根据配置,获取一个适配器实例,使用配置信息初始化
	 * @param $name			适配器名称如: db 类型由配置文件中确定
	 * @param $is_single	是否获取单例
	 * @param $cfg			初始化此适配器的配置数据,默认从配置中取
	 * @return 相应的适配器实例
	 */

	/**
	 * APP::adapter ($name,$type,$is_single=true,$cfgData=false);
	 * 通用的适配器获取方法
	 * @param $name			适配器名称
	 * @param $type			适配器类型
	 * @param $is_single	是否获取单剑
	 * @param $cfgData		适配器初始化参数
	 * @return 相应的适配器实例
	 */

	/**
	 * APP::ajaxRst($rst,$errno=0,$err='');
	 * 通用的 AJAX 或者  API 输出入口
	 * 生成后的JSON串结构示例为:
	 * 成功结果: {"rst":[1,0],"errno":0}
	 * 失败结果 :{"rst":false,"errno":1001,"err":"access deny"}
	 * @param $rst
	 * @param $errno 	错误代码,默认为 0 ,表示正常执行请求, 或者 >0 的 5位数字 ,1 开头的系统保留
	 * @param $err		错误信息,默认为空
	 * @param $return	是否直接返回数据,不输出
	 * @return unknown_type
	 */

	 * APP::tips($params,$display = true);
	 * 显示一个消息,并定时跳转
	 * @param $params Array
	 * 		['msg'] 显示消息,
	 * 		['location'] 跳转地址,
	 * 		['timeout'] = 3 跳转时长 ,0 则不跳转 此时 location 无效
	 * 		['tpl'] = '' 使用的模板名,
	 * 		如果$params不是数组,则直接当作 $params['msg'] 处理
	 * @param $display boolean 是否即时输出
	 */

	/**
	 * TPL::assign($k,$v=null);
	 * 给模板变量赋值,类似SMARTY
	 * 使用实例:
	 * TPL::assign('var_name1','var'); 在模板中可以使用  $var_name1 变量
	 * TPL::assign(array('var_name2'=>'var')); 在模板中可以使用  $var_name2 变量
	 * @param $k	当  $k 为字串时 在模板中 可使用以 $k 命名的变量 其值 为 $v
	 * 				当  $k 为关联数组时 在模板中可以使用 $k 的所有索引为变量名的变量
	 * @param $v	当  $k 为字符串时 其值 即为 模板中 以  $k 为名的变量的值
	 * @return 无返回值
	 */

	/**
	 * TPL::display($tpl, $langs=array(), $ttl=0, $tplDir="");
	 * 显示一个模板
	 * @param $tpl		模板路由
	 * @param $langs	语言包,可以是半角逗号隔开的列表,也可以是数组
	 * @param $ttl		缓存时间 单位秒 ( 未实现 )
	 * @param $baseSkin	模板基准目录选项,默认为 true ,将使用系统配置的皮肤目录
	 * @return 无返回值
	 */

	/**
	 * TPL::fetch($tpl,$langs=array(),$ttl=0, $tplDir="");
	 * 获取一个模板解释完后的内容
	 * @param $tpl		模板路由
	 * @param $langs	语言包,可以是半角逗号隔开的列表,也可以是数组
	 * @param $ttl		缓存时间 单位秒 ( 未实现 )
	 * @param $baseSkin	模板基准目录选项,默认为 true ,将使用系统配置的皮肤目录
	 * @return 模板解释完后的内容,字符串
	 */

	/**
	 * 输出或者获取一个 HTML 插件
	 * @param $tpl		模板路由
	 * @param $args		插件变量,是一个关联数组,在插件模板中,数组的下标即是变量名
	 * @param $baseSkin	模板基准目录选项,默认为 true ,将使用系统配置的皮肤目录
	 * @param $output	是否直接输出插件HTML代码,当其为FALSE时,返回插件内容	
	 * @return  相应的 HTML  插件代码
	 */


/**
 * 获取一个url APP::mkModuleUrl 的同名函数
 * @param $mRoute	模块路由
 * @param $qData	URL 参数可以是字符串如 "a=xxx&b=ooo" 或者数组 array('k'=>'k_var')
 * @param $entry	模块入口 默认为当前入口,可指定入口程序 如 admin.php
 * @return 			URL
 */

/**
	 * 调用一个数据交互方法、动作 dsMgr::call($dsRoute, $opt); 同名快捷函数为 DS($dsRoute, $opt);
	 * @param $eHandler	是否自动处理错误信息,默认为 TRUE
	 *							设置为 TRUE  时,将自动处理错误信息,并且退出程序,返回值为:真实数据结果
	 *							设置为 FALSE 时,将忽略错误,直接返回标准结果格式,返回值为:用 RST 封装过的标准结果结构
	 * @param $dsRoute	数据交互组件的路由
	 * @param $opt		数据交互的缓存与过滤策略,默认为空,不做任何缓存与过虑,
	 *					其规则如下:
	 *					[缓存组/]缓存时间[|过滤函数]  
	 *					  
	 *					缓存组,过滤函数 都是可选的,缓存时间为空表示不缓存,为0表示永久缓存,其它数值表示缓存的秒数
	 *					缓存组的可能值为:  空 、 i 、 g0,g1... 、 p0,p1... 、 s0,s1.... 、 u 
	 *					如: 	$opt = 123 			表示当前数据的调用会被缓存 123 秒
	 *					  	$opt = 'g1/223'		表示对当数据件交互产生缓存组,每个缓存周期是 223 秒
	 *											g1 表示根据数据调用组件的第一个参数作为标识,同理 g2,g3,g4
	 *											g0 表示根据数据调用组件的所有参数作为标识
	 *						$opt = 'g2/0|format_func1|format_func2'
	 *						表示,当前调用将会用第2个参数建立缓存组,建立永久缓存,第一次取数据时,
	 *						会依次用函数库的 	format_func1,format_func2 对组件数据进行格式化或者过滤处理			
	 *					
	 *						$opt = '|format_func';			
	 *						表示,当前调用不缓存,但需要使用 format_func 进行格式化或者过滤处理
	 *
	 *						$opt = '0|format_func'	以上例不同,此调用将做永久缓存			
	 * 
	 * @return 			见 $eHandler	 说明
	 */

/**
 * 格式化组件返回值,数据组件的返回值都要通过此函数格式化后返回
 * @param $rst  	结果数据
 * @param $errno	错误代码,默认为 0 无错误,其它值为相应的错误代码
 * @param $err		错误信息,默认为空,
 * @param $level	错误级别,默认为 0 , $err 将直接显示给用户看,如果为 1 则不显示给用户看,统一为提示为  系统繁忙,请稍后再试...
 * @param $log		当数据层需要 组件管理中心 写日志时,给出值,默认为空,不写日志
 * $return 返回标准的 RST 结果集
 */
function RST($rst, $errno=0, $err='', $level=0, $log=''){


?

另外我用xweibo搭建了个系统: 华软微博 http://sise.sinaapp.com/ ? 也欢迎大家知导。

觉得微博的行业细分,和信息的有效分类是非常好的一个方向。

?

?

发表评论
用户名: 匿名