1.4.2 入口文件

本节首先介绍了系统多个请求入口设计带来的不便，然后介绍了单一请求入口设计模式实现原理。本节的学习目标是明确单一入口文件设计模式的优点，避免在以后的开发项目中出现多入口。
1. 入口文件设计
系统中凡是能够被访问的PHP文件称为入口文件。如果用户的不同请求直接对应到Web服务器中的不同PHP文件，即系统是多入口设计。在刚开始学习 PHP的时候，通常一个项目都会这样做：
 index.php - 网站首页
 list.php?page=5 - 内容列表页
 info.php?id=12 - 内容详细页
 login.php - 用户登录页
又或者在上一小节实现MVC框架模式后，访问不同的控制器类文件，如DefaultController.php或SiteController.php。

对于这些项目来说，都有多个入口文件，随着项目规模的不断扩大，多入口的设计缺陷也会越来越明显，如系统目录结构混乱，后期维护困难，容易暴露程序漏洞，不便于系统的统一管理等。为了避免多入口设计带来的诸多问题，可以使用单一入口设计模式。单一入口设计模式就是一个文件处理所有的HTTP请求，也就是说访问任何控制器文件，不管是DefaultController.php、SiteController.php还是其他控制器类文件。每一次请求都是指向服务器的同一个文件，如入口文件index.php，该文件负责URL解析，最终转向所要访问的页面，即如图1-6所示。

图1-6 单一入口文件模式
PHP单一入口模式可谓是现在一种比较流行的大型Web应用开发模式，比如当前比较流行的一些PHP开发框架，Zend、Thinkphp，还有Yii 等都是采用单一入口模式。
使用单一入口文件模式的优点，如下所示。
 更加安全。单一入口模式给用户提供了单一的请求入口，所以我们在入口文件可以对请求进行过滤，加入安全处理代码，而传统的多请求入口模式需要为每个文件都加入安全处理程序块。
 模块化程度高。开发人员只需关注自己所开发的模块，开发人员之间不需考虑程序是否正常运行，因为这一切全部交给入口文件来协调。
 便于统一管理，定制性强。系统的所有模块都由入口文件进行统一管理，任何一个模块可以不经模块本身启用或禁用。

2. 入口文件中实现URL的解析
在上一节中提到入口文件的URL解析，即入口文件会将原始请求转发给相应的处理控制器，去完成具体的业务处理。如果URL地址如下。

http://<serverip>/
http://<serverip>/index.php
http://<serverip>/index.php?r=site
http://<serverip>/index.php?r=site/index

提示：自定义框架模仿Yii框架采用路径（PATH）URL模式访问规则。路径URL模式采用目录分层的思想，路径格式简洁，URL解析效率高，此URL格式为：http://<serverip>/appname/index.php?r=controllerID/actionID
我们希望上面所有URL被解析后都会访问SiteController控制器的actionIndex()方法。URL解析执行流程如图1-7所示，首先访问入口文件，在其中分析请求URL的参数，在没有“r”参数的情况下默认访问SiteController的actionIndex()方法，否则依据“r”参数访问SiteController的actionIndex()方法。即所有的访问由URL的参数来统一解析和调度。

图1-7 URL解析执行流程图
入口文件index.php中代码实现如下。

<?php//默认控制器是SiteController$defaultController="site";//默认动作actionIndex$defaultAction="index"; //http://localhost/index.php?r=controllerid/actionid//得到controllerid/actionidif(!empty($_GET['r'])){$route=$_GET['r'];//得到controllerid赋值给成员变量$pos=strpos($route,'/');$defaultController=substr($route,0,$pos);$defaultController=strtolower($defaultController);//得到actionid赋值给成员变量$defaultAction=(string)substr($route,$pos+1);}//得到控制器类名$className=ucfirst($defaultController).'Controller';//获得控制器文件路径$classFile="./controllers/".$className.'.php';//最后一步操作：该类文件存在则导入，该类存在则创建对象并调用acion方法。if(is_file($classFile)){if(!class_exists($className,false)){require($classFile);$class= new $className();$functionName="action".ucfirst($defaultAction);$class->$functionName();} }
?>

由上面的程序可知，默认的控制器是SiteController，默认的执行方法是actionIndex()方法。控制器的类名首字母大写，以“Controller”结尾，且控制器类文件必须保存在controllers文件夹中；动作方法名必须以“action”为前缀，acitonID首字母大写。从这段程序中也可以了解到代码规范的重要性，因为文件名或类名等都会在程序中使用。同样的道理，在将要学习的Yii框架开发过程中，也要遵守一定的编码规范。例如：命名变量、方法和类时使用驼峰风格，即每个单词的首字母大写并连在一起，中间无空格；变量名和方法名应该使它们的第一个单词全部小写，以使其区别于类名，如：$basePath, runController()；对私有类成员变量来说，推荐以下划线作为其名字前缀，如：$_actionList。
提示：为了使PHP语言开发的框架能够遵循共同的编码风格，在2009年由几个框架的开发者组成PHP-FIG（PHP Framework Interoperability Group）小组，一直扩展到现在已经拥有20多位成员。

实现入口文件后，框架执行流程如图1-8所示。

1. 用户发出了访问 URL 的请求，Web 服务器通过执行入口脚本index.php处理此请求。
2. 入口文件负责完成URL的解析，根据URL请求创建控制器并调用动作处理用户请求。
3. 控制器调用模型实例对象从数据库中读取数据。
4. 渲染视图。
5. 视图读取并显示模型的数据。
6. 动作完成视图渲染并将其返回给用户。

3. 单一入口模式服务器环境配置

实现单一入口模式之后，需要确保应用根目录下，除入口文件外的PHP文件（所有安全敏感的PHP文件）都不允许访问。通过实践证明使用Apache服务器的目录级配置文件.htaccess文件保护目录比使用其它方式更为有效和安全。更重要的是，使用.htaccess的方式进行设置，不需要编写程序就可以实现，具体操作比较容易。

（1）目录级配置文件.htaccess

.htaccess是一个纯文本文件，里面存放着Apache服务器配置相关的一些指令，它类似于Apache的站点配置文件，如httpd.conf文件。.htaccess与httpd.conf配置文件不同的是，它只作用于此目录及其所有子目录。另外httpd.conf是在Apache服务启动的时候就加载的，而.htaccess只有在用户访问目录时加载，所以修改.htaccess文件不需要重启Apache服务器。.htaccess的功能包括设置网页密码、设置发生错误时出现的文件、禁止读取文件、重新定向文件等。

在需要针对目录改变服务器的配置，而对服务器系统没有root权限时，应该使用.htaccess文件。如果服务器管理员不愿意频繁修改配置，则可以允许用户通过.htaccess文件自己修改配置，尤其是在一台机器上提供多个用户站点，而又期望用户可以自己改变配置的情况下，一般会开放部分.htaccess的功能给使用者自行设置。

注意：.htacess是一个完整的文件名，不是***.htaccess或其它格式。

如何允许用户使用.htaccess文件呢？在Apache服务器的配置文件httpd.conf中，查找服务器的根目录的配置信息：

……

AllowOverride None

……

</Directory>

在此块配置项中，把“AllowOverride None”修改成“AllowOverride All”。即允许Apache服务器调用.htaccess文件，在需要时针对目录改变服务器的配置。

提示：http.conf配置文件中的AllowOverride会根据设定的值决定是否读取目录中的.htaccess文件，来改变原来所设置的权限。为避免用户自行建立.htaccess文件修改访问权限，http.conf文件中默认设置每个目录为：AllowOverride None。

All：读取.htaccess文件的内容，修改原来的访问权限。

None：不读取.htaccess文件

（2）实现禁止访问除入口文件之外的PHP文件

在Apache服务器的目录级配置文件.htaccess文件中添加“Deny from all”（表示全部IP地址都不许可。相对地 allow from all表示全部都允许。）即可实现包含该.htaccess的文件夹不允许被外部访问。接下来创建protected目录，并把需要被保护的文件移到该目录下即可。改造后的目录结构如下

│ index.php

├─css

├─framework

│ .htaccess

│ CController.php

├─images

├─js

└─protected

│ .htaccess

├─controllers

│ DefaultController.php

│ SiteController.php

├─models

│ Article.php

└─views

index.php