FleaPHP的单入口文件详解

在 FleaPHP 应用程序使用 MVC 模式时，应用程序的所有功能都通过一个单一的文件来调用。这种通过单一文件来执行所有功能的应用程序，称为单一入口应用程序。

 

该文件通常放在程序主目录下。其代码如下所示：

Php代码  

1. <?php  
2. /** 
3.  * 入口文件 
4.  * 
5.  * @file：index.php 
6.  * @author：hegz 
7.  * @update：2009/10/27 
8.  */  
9.   
10. define('__ROOT__', dirname(__FILE__)); // 定义网站根目录  
11. define('DEPLOY_MODE', true); //部署模式时启用  
12. //define('NO_LEGACY_FLEAPHP', true); //取消与旧版FleaPHP兼容，现在作用不大  
13.   
14. // 装载 FleaPHP 框架文件  
15. require(__ROOT__ . '/lib/FLEA/FLEA.php');  
16.   
17. /** 
18.  * 装载配置文件 
19.  */  
20. FLEA::loadAppInf(__ROOT__ . DS . 'public/Config/COMMON_INF.php');　// 自定义环境配置文件  
21. FLEA::loadAppInf(__ROOT__ . DS . 'public/Config/DSN.php');　// 数据库链接参数配置文件  
22. FLEA::loadAppInf(__ROOT__ . DS . 'APP/Config/APP_INF.php'); // 自定义应用程序配置文件  
23.   
24. /** 
25.  * 设定运行目录 
26.  */  
27. FLEA::import(__ROOT__);  
28. FLEA::import(__ROOT__ . DS . 'APP');  
29. FLEA::import(__ROOT__ . DS . 'public');  
30.   
31. //dump($GLOBALS['__FLEA_CORE__']['CLASS_PATH']); // 调试程序路径  
32. //exit;  
33.   
34. // 以 MVC 模式运行系统  
35. FLEA::runMVC();  
36. ?>  

 

注意：上面代码中的 DS 为FleaPHP框架文件中定义的路径分隔符，是一个常量，Windows下为“\”，Linux下为“/”。

 

代码行解析

 

第十行：

Php代码  

1. define('__ROOT__', dirname(__FILE__));  

 

定义网站根目录的常量，其结果可能像下面所示：

e:\apmxe4\htdocs\mmfs2010

 

Linux下可能为：

/www/htdocs/mmfs2010

 

第十一行：

Php代码  

1. define('DEPLOY_MODE', true);  

 

程序部署在实际生产环境下使用时启用，这时程序将自动调用FleaPHP框架下的FLEA/FLEA/Config/DEPLOY_MODE_CONFIG.php配置文件初始化程序执行环境。
在开发环境下，需要详细显示一些出错信息，以方便调试，可以将true改为false，或直接屏蔽掉该语句即可。如下面所示：

Php代码  

1. define('DEPLOY_MODE', false);  

 

或直接屏蔽：

Php代码  

1. //define('DEPLOY_MODE', true);  

 

此时，程序将自动调用FleaPHP框架下的FLEA/FLEA/Config/DEBUG_MODE_CONFIG.php配置文件初始化程序执行环境。有时间的话，大家可以比较一下这两个文件里面的配置参数的异同。

第十五行：

Php代码  

1. require(__ROOT__ . '/lib/FLEA/FLEA.php');  

 

这个很好明白，就是装载FleaPHP框架文件FLEA.php，在框架文件装载过程中，将根据DEPLOY_MODE的参数值来装载默认配置文件。

第二十～二十二行：

Php代码  

1. FLEA::loadAppInf(__ROOT__ . DS . 'public/Config/COMMON_INF.php');  
2. FLEA::loadAppInf(__ROOT__ . DS . 'public/Config/DSN.php');  
3. FLEA::loadAppInf(__ROOT__ . DS . 'APP/Config/APP_INF.php');  

 

以上三个语句为装载一些自定义的配置文件，程序运行后将用自定义配置文件中的参数覆盖默认的全局配置参数。

其中:

COMMON_INF.php文件是一些公用的环境配置参数，如下所示：

Php代码  

1. <?php  
2.   
3. return array(  
4.     'controllerAccessor' => 'ctl',  
5.     'defaultController'  => 'Default',  
6.     'actionAccessor'     => 'act',  
7.     'urlLowerChar'       => false,  
8.     //'dispatcher'         => 'FLEA_Dispatcher_Auth',  
9.   
10.     /** 
11.      * 调度器调度失败（例如控制器或控制器方法不存在）后，要调用的自定义处理程序 
12.      */  
13.     'dispatcherFailedCallback'  => 'onDispatcherFailedCallback', //'dispatcher' = 'FLEA_Dispatcher_Simple'时启用  
14.     //'dispatcherAuthFailedCallback' => 'onAuthFailedCallback', //'dispatcher' = 'FLEA_Dispatcher_Auth'时启用  
15.   
16.     /** 
17.      * 指示在生成 url 时，是否总是使用应用程序入口文件名，仅限 URL_STANDARD 模式 
18.      * 
19.      * 如果该设置为 false，则生成的 url 类似： 
20.      * 
21.      * http://www.example.com/?controller=xxx&action=yyy 
22.      */  
23.     'urlAlwaysUseBootstrap'     => false,  
24.   
25.     /** 
26.      * 指示在生成 url 时，是否总是使用完整的控制器名和动作名 
27.      * 
28.      * 如果该设置为 false，则默认的控制器和动作名不会出现在 url 中 
29.      */  
30.     'urlAlwaysUseAccessor'      => false,  
31.   
32.     'responseCharset'    => 'gb2312',  
33.     'defaultLanguage'    => 'chinese-gb2312',  
34.     'databaseCharset'    => 'gb2312',  
35.     'RBACSessionKey'     => 'RBAC_MMFS2009',  
36.     //'autoResponseHeader'        => false,  
37.     'internalCacheDir'   => __ROOT__ . DS . '_cache',  
38.   
39.     /** 
40.      * WebControls 扩展控件的保存目录 
41.      */  
42.     'webControlsExtendsDir'     => __ROOT__ . DS . 'public/WebControls',  
43.   
44.     /** 
45.      * 指示是否启用日志服务，设为true时启用 
46.      */  
47.     'logEnabled'         => false,  
48.   
49. );  
50.   
51. ?>  

 

DSN.php为数据库链接参数定义文件，如下所示：

Php代码  

1. <?php  
2. /** 
3.  * 数据库连接参数 
4.  */  
5. return array(  
6.     'dbDSN'     => array(  
7.         'driver'        => 'mysql',  
8.         'host'          => 'localhost',  
9.         'login'         => 'mmfs2009',  
10.         'password'      => '×××××××',  
11.         'database'      => 'mmfs2009',  
12.     )  
13. );  
14.   
15. ?>  

 

APP_INF.php为自定义前台程序运行参数文件，如下所示：

Php代码  

1. <?php  
2.   
3. return array(  
4.     'dispatcher'       => 'FLEA_Dispatcher_Auth',  
5.   
6.     /** 
7.      * 指示 RBAC 组件要使用的默认 ACT 文件（使用单个ACT文件） 
8.      */  
9.     'defaultControllerACTFile' => __ROOT__ . DS . 'APP/Controller/App.act.php',  
10.   
11.     'view' => 'FLEA_View_Smarty',  
12.     'viewConfig' => array(  
13.         'smartyDir'         => __ROOT__ . DS . 'lib/Smarty',  
14.         'template_dir'      => __ROOT__ . DS . 'APP/Templates',  
15.         'compile_dir'       => __ROOT__ . DS . '_cache/1',  
16.         'left_delimiter'    => '{{',  
17.         'right_delimiter'   => '}}',  
18.     ),  
19. );  
20. ?>  

 

这三个配置文件为什么不合并到一个配置文件中呢？这个是可以的，但在有些场合下使用起来不太方便，也不方便修改。一般来说，公共配置参数配置好后很少改动，但数据库参数链接参数在部署到生产环境中时，很可能需要修改的。还有，考虑到前台程序与后台程序拆分成两个目录的情况，如果后台也有一个入口文件的话，很多参数也发生了变化，比如路径参数，使得前后台程序都需要有各自的一套运行参数，这时将配置文件拆分就很有好处了。

第二十七～二十九行：

Php代码  

1. FLEA::import(__ROOT__);  
2. FLEA::import(__ROOT__ . DS . 'APP');  
3. FLEA::import(__ROOT__ . DS . 'public');  

 

以上语句用来设定程序的运行目录。执行程序后，将把路径数据放入全局数组$GLOBALS['__FLEA_CORE__']['CLASS_PATH']中存放，以方便后续使用。

import()在框架文件中定义，这是一个静态方法。其代码为：

Php代码  

1. /** 
2.  * 导入文件搜索路径 
3.  * 
4.  * FLEA::loadClass()、FLEA::getSingleton() 会在搜索路径中查找指定名字的类定义文件。 
5.  * 因此需要调用 FLEA::import() 将存放类定义文件的目录添加到搜索路径中。 
6.  * 但是，不应该将类文件所在目录直接添加到搜索路径中，而是根据类的命名来决定要添加哪一个目录。 
7.  * 
8.  * 例如类名称是 Table_Posts，而实际的文件是 ./APP/Table/Posts.php。 
9.  * 那么应该添加的目录就是 ./APP，而不是 ./APP/Table 。 
10.  * 
11.  * example: 
12.  * <code> 
13.  * FLEA::import(APP_DIR . '/LIBS'); 
14.  * </code> 
15.  * 
16.  * @param string $dir 
17.  */  
18. function import($dir)  
19. {  
20.     if (array_search($dir, $GLOBALS[G_FLEA_VAR]['CLASS_PATH'], true)) { return; }  
21.     if (DIRECTORY_SEPARATOR == '/') {  
22.         $dir = str_replace('\\', DIRECTORY_SEPARATOR, $dir);  
23.     } else {  
24.         $dir = str_replace('/', DIRECTORY_SEPARATOR, $dir);  
25.     }  
26.     $GLOBALS[G_FLEA_VAR]['CLASS_PATH'][] = $dir;  
27. }  

 

现在来看看，执行了三个FLEA::import()语句后，$GLOBALS['__FLEA_CORE__']['CLASS_PATH']里有什么 东西。
去掉index.php文件中下面语句的两个反斜线，如下面所示：

Php代码  

1. //dump($GLOBALS['__FLEA_CORE__']['CLASS_PATH']); // 调试程序路径  
2. //exit;  

 

去掉双斜线：

Php代码  

1. dump($GLOBALS['__FLEA_CORE__']['CLASS_PATH']); // 调试程序路径  
2. exit;  

 

执行程序，结果显示如下：

Array
(
[0] => e:\apmxe4\htdocs\mmfs2010\lib\FLEA
[1] => e:\apmxe4\htdocs\mmfs2010
[2] => e:\apmxe4\htdocs\mmfs2010\APP
[3] => e:\apmxe4\htdocs\mmfs2010\public
)

 

说明一下：

mmfs2010 -- 程序主目录，
lib\FLEA -- FleaPHP框架文件存放目录
APP -- 前台应用程序目录，里面含有Config、Controller、Templates子目录
public -- 公共文件存放目录，里面含有Config、Model、Table、WebControls等子目录

第三十五行：

Php代码  

1. FLEA::runMVC();  

 

这是入口文件中的最后一个语句，以 MVC 模式运行系统。如果是以非 MVC 模式运行系统，则执行

Php代码  

1. FLEA::init();  

 

命令。

FLEA::init() 主要完成下列工作： 

安装 FleaPHP 异常的处理例程 
根据应用程序设置设置决定是否载入日志服务 
检查 php.ini 中 magic_quotes 设置是否为 on，并将被 PHP 自动转义后的数据撤销转义 
根据应用程序设置的 urlMode 决定是否对 URL 进行处理 
根据应用程序设置 requestFilters 决定运行哪些输入过滤器 
根据应用程序设置 autoLoad 决定自动载入哪些文件 
根据应用程序设置 sessionProvider 和 autoSessionStart 决定使用哪一个 session 服务 
根据应用程序设置 responseCharset 和 requestCharset 定义常量 RESPONSE_CHARSET 和 DATABASE_CHARSET 
根据应用程序设置 multiLangaugeSupport 决定是否载入多语言支持 
根据应用程序设置 autoResponseHeader 决定是否自动输出 HTTP HEADER 信息 
这些初始化工作对于应用程序的绝大部分来说都是必须。因此务必记得在 require('FLEA.php') 后要调用 FLEA::init()。

FLEA::runMVC()的作用：

如果要使用 FleaPHP 的 MVC 模式。那么在载入 FLEA.php 后，调用 FLEA::runMVC() 即可启动 MVC 模式。 
在 MVC 模式启动后，FleaPHP 会根据 URL 地址中包含的控制器名称和控制器动作名称，执行开发者编写的控制器代码。

其实，FLEA::runMVC()内部也调用了FLEA::init()方法。