[学习] 单一入口应用程序概述

dualface

看到置顶的讨论贴，所以想多说两句。

[火爆热烈讨论中......] PHP参数提交入口问题  - http://bbs.chinaunix.net/viewthr ... &extra=page%3D1



什么是单一入口应用程序？

在解释什么是单一入口应用程序之前，我们先来看看传统的 web 应用程序。
news.php 显示新闻列表
news_edit.php 显示新闻编辑页面
这两个页面不但分别实现了两个功能，还成为了应用程序的两个入口。

那什么是入口啊？
打个比方，大家上 WC，都是男生进一个门，女生进一个门。这两个门就是 WC 的两个入口。

呵呵，上面的例子应该很好理解吧。那稍微变换一下，单一入口的概念就很容易理解了。
现在我们是进一个公共 WC，不管男女都是从最外面的入口进入，交了钱以后才分别进两个门。那最外面的入口就是这个 WC 的单一入口。

所以单一入口的应用程序实际上就是说用一个文件处理所有的 HTTP 请求。例如不管是新闻列表功能还是新闻编辑功能，都是从浏览器访问 index.php 文件。这个 index.php 文件就是这个应用程序的单一入口。


index.php 如何知道用户是要使用哪一个功能呢？

很简单，我们访问 index.php 时跟上一个特定的参数就行了。例如 index.php?action=news 就是显示新闻列表，而 index.php?action=news_edit 就是新闻编辑。

而在 index.php 里面，仅用两行代码就可以实现这种效果。
<?php
$action = $_GET['action'] == '' ? 'index' : $_GET['action'];
include('files/' . $action . '.php');
?>

上面的代码中，第一行是从 url 中取出 action 参数。如果没有提供 action 参数，就设置一个默认的 'index' 作为参数。
第二行代码就是根据 $action 参数调用不同的代码文件，从而实现单一入口对应不同功能的效果。


单一入口应用程序的入口文件很复杂？

有些朋友可能以为单一入口程序的 index.php 会像面条一样复杂，其实是误解。
例如我现在的应用程序入口文件只有下面几行：
<?php
define('APP',       realpath('../libs/website'));
define('LANG',      'gb2312');
define('DEBUG',     1);

require('../libs/flea1/basic.php');
run();
?>
足够简单了吧？

当然了，在 index.php 里面写上一长串 switch case 绝对是拙劣的实现方式。但这纯粹是开发者自己的设计和实现问题，而不是单一入口应用程序这种设计思想的问题。

补充说明： 这里提到 switch case 并不是说用了 switch 就代表“落后”、“土气”等。只是说在 index.php 这个入口程序里面写上一堆 switch case 不利于程序的修改和维护，所以是一种不好的用法。


单一入口应用程序的设计思想

当web服务器（apache或者iis）收到一个http请求时，会解析该请求，确定要访问哪一个文件。例如 http://www.xxx.com/news.php 的解析结果就是要求web服务器解析 news.php 文件，并返回结果给浏览器。现在看看单一入口应用程序的 index.php 文件，就会发现 index.php 实际上根据 url 参数进行了第二次解析。

完成这个解析的程序一般称为 Dispatcher（中文的准确翻译我也不知道），大概意思就是将不同的请求转发到不同的处理程序进行处理。

在单一入口应用程序中，index.php 和 web服务器一起构成了一个 Dispatcher，根据 http 请求和 url 参数来确定请求的处理程序。

了解了 Dispatcher 的概念后，我们可以发现前面提到的两行代码实际上就是一个最简单的 Dispatcher 实现：
<?php
$action = $_GET['action'] == '' ? 'index' : $_GET['action'];
include('files/' . $action . '.php');
?>

诚然，对于一个安全、健壮的应用程序，Dispatcher 肯定不是上面那么简单。在调用实际代码前，还会加上各种判断、安全性检查等。例如判断 url 指定的功能是否可以访问以及 url 中包含了无效的参数。

看到这里，朋友们肯定会说：单一入口程序就多了就这样一个 dispatcher ，和我直接做成 news.php、news_edit.php 等单个文件相比有什么好处啊？


单一入口应用程序的优势

单一入口应用程序的所有http请求都是通过 index.php 接收并转发到功能代码去的，所以我们在 index.php 里面就能完成许多实际工作。

这里我只拿安全性检查为例详细说明一下：
由于所有的 http 请求都由 index.php 接收，所以可以进行集中的安全性检查。如果不是单一入口，那么开发者就必须记得在每一个文件的开始加上安全性检查代码（当然，安全性检查代码可以写到另一个文件中，只需要include进来就可以了）。
但我想大家都是懒人，也许记性也不好，难免有忘记的时候。因此要记得在每一个文件前面都加上必要的include可不是件容易做到的事情。

与安全性检查类似。在入口里，我们还可以对url参数和post进行必要的检查和特殊字符过滤、记录日志、访问统计等等各种可以集中处理的任务。

“咦，搞这么多功能，不是会把 index.php 搞得很复杂吗？”
“不会的。只需要把各种功能写到单独的文件，然后在index.php里面include进来就可以了！”

可以看出，由于这些工作都被集中到了 index.php 来完成，可以减轻我们维护其他功能代码的难度。例如在10个文件中保持头部的几个include都一致可不是件让人愉快的事情。


单一入口应用程序的缺点

任何事情都有两面性，单一入口应用程序也不例外。由于所有 http 请求都是针对 index.php，所以应用程序的 url 看起来确实不那么美观。特别是对搜索引擎来说很不友好。

要解决这个问题，可以采用 url 重写、PATHINFO 等方式。但我个人更推荐在前台页面不使用单一入口方式，而是保持多个文件入口。或者两者混用。例如新闻列表采用单独的 news.php 显示，而用户注册、发表信息等则采用单一入口。因为对于网站拥有者来说，新闻列表、新闻显示页面才是需要搜索引擎关注的高价值目标，而用户注册页面等交互性功能则根本没有收录的价值。

有朋友提到单一入口的应用程序会有很长一串参数，那么我们分析一下下面这个 url：
index.php?url=news&news_id=123&page=2&sort=title
如果改为直接访问 news.php，也只不过省掉了 url=news 这一个参数而已。

所以认为单一入口的应用程序 url 太复杂是没有道理的。


如何组织单一入口应用程序的功能代码？

单一入口应用程序最大的挑战来自于如何合理组织各个功能的处理代码。但只要遵循一定的步骤，也可以轻松的解决掉这个难题。

首先，对于应用程序的功能要做出一个合理的分解。例如后台的新闻栏目可能包含“添加新闻”、“编辑新闻”、“删除新闻”等多个功能。这时我们就可以将这一组逻辑上关联的功能组合到一个功能模块中，称为“新闻管理”模块。
按照上面的方法整理完应用程序的功能，我们就会得到多个功能模块，而每个模块又是由多个功能组成。（实际上，即便不是单一入口应用程序，功能的整理也是必须的步骤。）

整理完功能后，我们就需要确定如何存放各个功能的代码。这里我推荐两种方式：

1、每个功能模块一个子目录，目录里的每一个文件就是一个功能的实现代码。
这种方式的好处是每个功能的代码都互相隔离，非常便于多人协作。缺点是每个功能之间共享代码和数据不那么方便。例如新闻管理模块中的所有功能都需要一个“取出新闻栏目记录”的功能，那么采用这种多个独立文件的组织方式，“取出新闻栏目记录”就只能写在另一个文件中，然后由需要该功能的文件include进去。

2、每个模块一个文件，模块中的每个功能写成一个函数或者一个类方法。
好处不用多说了，非常便于共享代码和数据。缺点就是如果几个人同时改，容易发生冲突。不过借助版本控制软件和差异比较合并工具，冲突还是很容易解决的。


好了，我们的功能代码都确定存放方式了。那么如何调用呢？


index.php 如何调用功能代码？

调用首先就是要设计一个规则，然后让 index.php 根据这个规则来搜索和调用功能代码。就我自己来说，我总是使用 $_GET['url'] 来指定要调用的功能模块，而 $_GET['action'] 来指定该模块的特定功能。因此我的应用程序会使用如下的 url 地址：
index.php?url=news&action=edit

觉得两个参数太多了？那可以使用 index.php?func=news.edit 这样的 url。只需要将 news.edit 拆开为 news 和 edit 就行了。

“嘿嘿，那我故意搞一个 index.php?url=news&action=xxx，看你的应用程序还能运行？”
很显然，这样的 url 只会使得 index.php 无法找到需要的功能代码，最后报告错误。但是这和你在浏览器中访问 newsxxx.php 这个并不存在的文件有什么本质区别呢？

相反，我还可以让 index.php 在发现找不到需要的功能代码时显示一个漂亮的出错页面，并提供一个返回网站首页的连接。

在实际开发中，我倾向于将一些基本服务从应用程序中抽取出来，形成一个应用程序框架。这个框架通常会包含一个 Dispatcher、基本的数据库访问服务、模版引擎、常用的辅助功能等。由于有了一个框架，所以我可以更加让 Dispatcher 更加灵活。例如可以对某些功能模块应用权限检查，而另一些则不检查。


进一步了解单一入口应用程序

要深刻理解一个事物，自己尝试一下是最好的办法。

你可以选择自己实现一个 Dispatcher 以及相应的各种规则，或者选择一个现有的应用程序框架。但更好的方式还是首先尝试一下现有的框架，然后再自己尝试实现一个类似的。这样可以在最短的时间内获得最多的收获。

目前绝大多数 php 应用程序框架都是单一入口的，并采用了 MVC 模式（很遗憾，由于 MVC 实在太复杂，并且和单一入口应用程序也没有必然联系，所以我就不赘述了。感兴趣的朋友可以 google 一下相关资料）。

我个人推荐下面的框架：

FleaPHP
http://www.fleaphp.org/
嗯，我在做广告。因为这个框架是我做的。但我相信这个框架将是一个非常容易上手（就算不是最容易的）框架。
全中文的代码注释、简单的结构、精简的代码都是 FleaPHP 框架的优势。


CakePHP
http://www.cakephp.org/
一个 Ruby on Rails 的 PHP 仿制品。具有出色的功能，但显然太过于复杂，而且缺乏中文资料是个很大的问题。


symfony
http://www.symfony-project.com/
一个超复杂的框架，集成了 n 多东西。项目网站上提供的视频演示看上去很不错。


其他
还有 Mojavi、Phing 等许多 PHP 框架，如果你精力充沛，可以去探索一下。

[ 本帖最后由 dualface 于 2006-9-11 13:02 编辑 ]

cpbai

顶

trask

以前就发现ipb是这样的

dz902

这里我只拿安全性检查为例详细说明一下：
由于所有的 http 请求都由 index.php 接收，所以可以进行集中的安全性检查。如果不是单一入口，那么开发者就必须记得在每一个文件的开始加上安全性检查代码（当然，安全性检查代码可以写到另一个文件中，只需要include进来就可以了）。
但我想大家都是懒人，也许记性也不好，难免有忘记的时候。因此要记得在每一个文件前面都加上必要的include可不是件容易做到的事情。

这一点有些牵强。

qingmedia

城里人吃肉的时候，咱乡下人吃野菜；
咱乡下人吃上肉了，城里人却吃又野菜。

唉，我刚刚把我的论坛从单一入口改为多个入口，因为我大致算过，单一入口的话，每个帖子要多出10个字节，一个页面常有200个帖子，这样就多出2K的数据，能省就省一点。

不过我写的管理后台采用了一种简单的单一入口方法，我把每个功能做成一个插件目录，让入口index.php自动去搜索并按一定条件挂接，这样就不用switch了（原来是这样的，比较土）

trask

使用switch就一定土气？

PHP手册上的

1. 
   
2. 例子 10-1. 高级分离术
   
3. 
   
4. <?php
   
5. if ($expression) {
   
6.     ?>
   
7.     <strong>This is true.</strong>
   
8.     <?php
   
9. } else {
   
10.     ?>
    
11.     <strong>This is false.</strong>
    
12.     <?php
    
13. }
    
14. ?>  
    
15. 
    
16. 上例可正常工作，因为当 PHP 碰到结束标记 ?> 时，就简单地将其后的内容原样输出直到碰到下一个开始标记为止。当然，上面的例子很做作，但是对输出大块的文本而言，脱离 PHP 解析模式通常比将所有内容用 echo() 或者 print() 输出更有效率。
    

复制代码

很多东西可以一下直接出来的，可偏要echo()、print()，甚至还object->()，大致认为这样用才算洋气？我还曾遇到过这样的，用Dreamweaver来写php，别人笑他，说混合html，真不知道是先客为主还是后客为主？先有html还是先有php。诚然，使用什么写法是个人习惯，不一定就使用switch效率低下，实现目的才是真的。

我以后就打算用Dreamweaver来写php，一个留言板，三点两点就出来。

hightman

原帖由 trask 于 2005-11-27 01:33 发表
使用switch就一定土气？

PHP手册上的

[code]
例子 10-1. 高级分离术

<?php
if ($expression) {
    ?>
    <strong>This is true.</strong>
    <?php
} else {
    ?>
...

没错,这样的写法从执行效率应该是最高的, 也是 PHP的初衷. 将 PHP当成一个 "模板" 在使用.

但如果你的程序常常需要修改, 程序也相对复杂一些(代码较长)的时候, 那么这种编写方式也会带来一些不方便之处.

所以才有了在PHP这个大模板基础上重新开发的模板.

dualface

原帖由 dz902 于 2005-11-27 00:58 发表


这一点有些牵强。

这句话是半开玩笑半认真的，不过确实有点牵强。

dualface

原帖由 qingmedia 于 2005-11-27 01:14 发表
城里人吃肉的时候，咱乡下人吃野菜；
咱乡下人吃上肉了，城里人却吃又野菜。

唉，我刚刚把我的论坛从单一入口改为多个入口，因为我大致算过，单一入口的话，每个帖子要多出10个字节，一个页面常有200个帖子， ...

任何东西都有自己的适用的场合。像论坛这种要求高性能的应用程序，应该具有最简化的代码执行路径。单一入口肯定会增加一些负担。

最后实在是衷心佩服老兄为了2k字节仔细优化程序，确实敬业

imbiss

不全面。单一入口就是include ($var.inc )的这种方法？？（不喜欢主要是觉得不安全。用户可以任意include他要的文件阿）
我的单一入口blog+debug内容，本质上我用的是switch

1. 
   
2. <?php
   
3. ob_start();
   
4. $debug =false;
   
5. $querycount = 0;
   
6. $counter =0;
   
7. if($debug){$start_sec =time()+microtime(); }       
   
8. 
   
9.                 require_once  ("_lang/zh.php");
   
10.                 require_once ("_inc/class_ibsObject.php");
    
11.                 require_once ("_inc/class_Logic.php");               
    
12.                 require_once ("_inc/class_Render.php");               
    
13.                 require_once ("_inc/config.php");               
    
14.                 require_once ("_inc/function.php");
    
15.                 require_once ("_inc/db_mysql.php");
    
16.                 require_once ("_inc/template.php"); //template class
    
17.                 require_once ("_inc/class_blogpage.php");
    
18.                 require_once ("_inc/class_viewer.php");               
    
19.                 require_once ("_inc/calendar.php");       
    
20.                 require_once ("_inc/class_blogGroup.php");
    
21.                 require_once ("_inc/class_headObj.php");
    
22.                 require_once ("_inc/class_categorie.php");
    
23.                 require_once ("_inc/class_comment.php");
    
24.                 require_once ("_inc/class_commentgroup.php");
    
25.                 require_once ("_inc/class_autor.php");
    
26.                 require_once ("_inc/class_pagespliter.php");
    
27.                 require_once ("_inc/class_archive.php");
    
28.                 require_once ("_inc/bbcode.php");
    
29.                 require_once ("_inc/class_StyleSwitch.php");
    
30.                 require_once ("_inc/chinese/class.Chinese.php");
    
31.                 require_once ("_inc/class_log.php");
    
32.                 require_once ("_inc/class_userLogic.php");
    
33.                 require_once ("_inc/class_UserRender.php");
    
34.                 require_once ("_inc/class_userTemplate.php");
    
35. $db= new DB_Sql;
    
36. $db->connect();
    
37. 
    
38. /************ Logic Module ************/
    
39. $logic = new userLogic($_REQUEST);
    
40. $render = new userRender(&$logic);
    
41. $output = $render->getOutput();
    
42. 
    
43. $render->destory();
    
44. $logic->destory();
    
45. 
    
46. 
    
47. $db->free();
    
48. 
    

复制代码

大家提个意见
把入口参数转到logic，在里面用switch。

[ 本帖最后由 imbiss 于 2005-11-27 18:53 编辑 ]