一、初始化过程
1、94hwan-PHP框架的入口点都是加载根目录的 init.php 来初始化的,因此在这里主要介绍一下初始化时到底做了一些什么。
// 严格开发模式
error_reporting( E_ALL );
//开启register_globals会有诸多不安全可能性,因此强制要求关闭register_globals
if(ini_get('register_globals') )
{
exit('php.ini register_globals must is Off! ');
}
//核心库目录
define('CORE', dirname(__FILE__));
//系统配置
requireCORE.'/../config/inc_config.php';
//外部请求程序处理(路由)
requireCORE.'/req.php';
req::init();
//设置时区
date_default_timezone_set( $GLOBALS['config']['timezone_set'] );
//加载核心类库
requireCORE.'/util.php';
requireCORE.'/db.php';
requireCORE.'/tpl.php';
requireCORE.'/log.php';
requireCORE.'/cache.php';
//debug设置
$_debug_safe_ip= false;
requirePATH_LIBRARY.'/debug/lib_debug.php';
if( in_array( util::get_client_ip(),$GLOBALS['config']['safe_client_ip']) || OPEN_DEBUG === true )
{
$_debug_safe_ip= true;
ini_set('display_errors','On');
}
else
{
ini_set('display_errors','Off');
}
set_exception_handler('handler_debug_exception');
set_error_handler('handler_debug_error', E_ALL);
register_shutdown_function('handler_php_shutdown');
//session接口(使用session前需自行调用session_start)
requireCORE.'/session.php';
/**
* 程序结束后执行的动作
*/
functionhandler_php_shutdown()
{
show_debug_error();
log::save();
if( defined('CLS_CACHE') ) {
cache::free();
}
if( defined('CLS_CACHE_NATIVE') ) {
cls_cache_native::close();
}
}
/**
* 致命错误处理接口
* 系统发生致命错误后的提示
* (致命错误是指发生错误后要直接中断程序的错误,如数据库连接失败、找不到控制器等)
*/
functionhandler_fatal_error($errtype,$msg)
{
global$_debug_safe_ip;
$log_str=$errtype.':'.$msg;
if( OPEN_DEBUG === true ||$_debug_safe_ip)
{
thrownewException($log_str);
}
else
{
log::add('fatal_error',$msg);
header ( "location:/404.html");
exit();
}
}
/**
* 路由控制
*
* @param $ctl 控制器
* @parem $ac 动作
* @return void
*/
functionrun_controller()
{
try
{
$ac= preg_replace("/[^0-9a-z_]/i",'', req::item('ac','index') );
$ac=emptyempty($ac) ?$ac='index':$ac;
$ctl='ctl_'.preg_replace("/[^0-9a-z_]/i",'', req::item('ct','index') );
$path_file= PATH_CONTROL .'/'.$ctl.'.php';
if(file_exists($path_file) )
{
require$path_file;
}
else
{
thrownewException ("Contrl {$ctl}--{$path_file} is not exists!");
}
if( method_exists ($ctl,$ac) === true )
{
$instance=new$ctl( );
$instance->$ac();
}
else
{
thrownewException ("Method {$ctl}::{$ac}() is not exists!");
}
}
catch ( Exception $e)
{
handler_fatal_error( 'init.php run_controller()',$e->getMessage().' url:'.util::get_cururl() );
}
}
/**
* 自动加载类库处理
* 加载优先级 /core/library => 应用目录/model => 根目录/model
* (如果不在这些位置, 则需自行手工加载,对于小型项目,也可以把model全放到library以减少类文件查找时间)
* @return void
*/
function__autoload($classname)
{
$classname= preg_replace("/[^0-9a-z_]/i",'',$classname);
if(class_exists($classname) ) {
returntrue;
}
$classfile=$classname.'.php';
try
{
if(file_exists( PATH_LIBRARY.'/'.$classfile) )
{
requirePATH_LIBRARY.'/'.$classfile;
}
elseif(file_exists( PATH_MODEL.'/'.$classfile) )
{
requirePATH_MODEL.'/'.$classfile;
}
elseif(file_exists(requirePATH_ROOT.'/model/'.$classfile) )
{
requirePATH_ROOT.'/model/'.$classfile;
}
else
{
returnfalse;
thrownewException ('Error: Cannot find the '.$classname);
}
}
catch ( Exception $e)
{
handler_fatal_error( 'init.php __autoload()',$e->getMessage().'|'.$classname.' url:'.util::get_cururl() );
}
}
/**
* req::item 别名函数
*/
functionrequest($key,$df='')
{
returnreq::item($key,$df);
}
说明一:新版框架最大的不同之处是,在引导文件里引入了重新封装过几个重要核心类,这些东西加起来,其实就是组成了最迷你的一个框架,但是功能少却基本完全兼顾,包括下面几个方面:
(1) 路由功能req.php:即是全局环境检查与请求参数初始化;
(2) 基本数据库类db.php:因为数据库类是最常用的的类,因此名称跳出规范的标准,直接使用db作为名称,更便于记忆;
(3) 视图类tpl.php:视图类是MVC框架里不可缺少的东西,本框架通过对smarty进行简化封装后,得到的 tpl 类,即是相当于别的框架的视图对应的功能;
(4) 缓存类cache.php:支持本地单文件hash缓存和memcache缓存,取代原来memcache + 打散文件的模式(这种模式缺点是时间长之后文件碎片极多,造成维护困难);
(5) 日志类log.php:目前仅进行了简单的规范;
(6) 调试程序debug/lib_debug.php:引导文件中定义了debug的方案并且定义了register_shutdown_function接口。
(7) session(sesion.php):重写了session接口,确保在各种场合下都可以使用session。
(8) 引导功能:定义了如何引导到控制器和加载类库路径(un_controller、__autoload)。
说明二:通过分析上面入口源码,必须重点清楚几个事情:
(1)、传入系统的请求参数都是已经转义的,如果需要用到不转义的情况,需要还原后使用;
(2)、对于_GET、_POST、_FILES ,不要再使用原来的操作方法,而是使用 req类去操作(具体可以参考类文档);
(3)、/core/library 目录存放的是系统基础类和公共类文件,不要存放 mod_*.php(如果是很小的项目则没关系),公共接口类要存放这个位置的用 pub_*.php 命名,普通模型类应该存放在 应用目录/model 文件夹,并命名为 mod_*.php (私有逻辑类编程规范里要求用静态成员方法)。
2、分析入口文件 index.php 这里分别把 /index.php 和 admin/index.php 列出来,对比这它们的不同
/index.php
header('Content-Type: text/html; charset=utf-8');
$page_start_time= microtime(true);
require'./init.php';
$config_pool_name=$config_appname=$config_cp_url='';
execute_ctl(req::$forms['ct'], req::$forms['ac']);
?>
admin/index.php
header('Content-Type: text/html; charset=utf-8');
$page_start_time= microtime(true);
require'../init.php';
$config_pool_name='administrator';//应用池参数(与权限管理有关)
$config_appname='admin';//应用名称(与模板文件夹有关,不一定与应用池名称一致)
$config_cp_url='?ct=index&ac=login';//用于未登录用户跳转到的url
cls_template::assign('URL', URL);
//前置的权限控制器
$config_access_ctl= cls_access::factory($config_pool_name,$config_cp_url);
$config_access_ctl->test_purview( req::$forms['ct'], req::$forms['ac'],'1');
execute_ctl( req::$forms['ct'], req::$forms['ac'] );
?>
通过对比,不难看出,admin 目录的入口文件与根目录相比,主要多了如下代码:
$config_pool_name = 'administrator'; //应用池参数(与权限管理有关)
$config_appname = 'admin'; //应用名称(与模板文件夹有关,不一定与应用池名称一致)
$config_cp_url = '?ct=index&ac=login'; //用于未登录用户跳转到的url
//前置的权限控制器
$config_access_ctl = cls_access::factory( $config_pool_name, $config_cp_url );
$config_access_ctl->test_purview( req::$forms['ct'], req::$forms['ac'], '1' );
上面的代码实际上就是权限控制类的代码,权限控制类通过监听 ct 和 ac 实现对权限的控制的,权限类里对角色分两种情况处理,一种是组权限,在没指定用户具体权限的情况下,通过组权限配置来识别用户权限,在指定了用户具体权限的情况下,以指定的独立权限为准。
此外,细心的人可能会发现 $forms['ct'], $forms['ac'] 居然没预先判断是否存在,实际上其实在 req 类中,对ct和ac为空的情况会默认赋值为 index,当然如果是其它变量,用:
req::item(formName, 默认值) 或直接使用 request(formName, 默认值)
这样获取即可。
二、程序运行过程
通过分析源码,不难知道,程序最终要调用的文件和执行的类及方法,主要在 run_controller() 这函数里处理。
它的源码如下:
/**
* 路由控制
*
* @param $ctl 控制器
* @parem $ac 动作
* @return void
*/
functionrun_controller()
{
try
{
$ac= preg_replace("/[^0-9a-z_]/i",'', req::item('ac','index') );
$ac=emptyempty($ac) ?$ac='index':$ac;
$ctl='ctl_'.preg_replace("/[^0-9a-z_]/i",'', req::item('ct','index') );
$path_file= PATH_CONTROL .'/'.$ctl.'.php';
if(file_exists($path_file) )
{
require$path_file;
}
else
{
thrownewException ("Contrl {$ctl}--{$path_file} is not exists!");
}
if( method_exists ($ctl,$ac) === true )
{
$instance=new$ctl( );
$instance->$ac();
}
else
{
thrownewException ("Method {$ctl}::{$ac}() is not exists!");
}
}
catch ( Exception $e)
{
handler_fatal_error( 'init.php run_controller()',$e->getMessage().' url:'.util::get_cururl() );
}
}
这个函数是通过控制器名称来确定要调用的 control 类文件,并且,初始化这个类,并调用里面的 action(ac) 方法。
PATH_CONTROL == './control'
在上面源码有,有一处语法:empty ( $action ) && $action = 'index';
这种语法是不规范的,倒不是说不合乎PHP标准,而是不具可读性,对于没用过这种方式的人,读起来会很费劲,过于个性化,这是历史留下来的问题,这里我不作修改,让后来人作为反面参考教材。
通过分析源码,相信大家都能明白在94hwan框架下是如何进行开发的了,其实主要是两个方面:
1、URL里的ct 和 ac 表示指向 control/ct_ctname.php 里的 action(ac) 方法,开发人员的工作就是写这个ct类和ac方法,但需要注意的是控制器只负责的用户请求进行控制,逻辑代码应该放在 model 目录的相应类, 或 library 里的框架基础类或项目接口类, 除了lurd类之外,尽量不要在 ac 类直接操作数据库,过于复杂的代码都要封装为逻辑类。
2、框架要求对 GET、POST、FILES 请求都用 req 类,因此,开发前必须先完全弄明白这个类的使用方法。