Symfony中控制层包含了连接业务逻辑与表现的代码,控制层为不同的使用分成了几个不同的部分。
l 前端控制器是指向应用的唯一入口
l 动作包含了应用的逻辑,他们检查请求的完整性并准备好表示层需要的数据
l 请求、响应和Session对象提供访问请求参数、响应参数以及持久的用户数据,这些数据在控制层使用的很普遍
l 过滤器是每个请求都要执行的代码的一部分,无论在动作前还是在动作后。可以自创过滤器。
所有WEB请求都将被前端控制器捕获,前端控制是给定环境下整个应用的唯一入口点。当前端控制接到一个请求,他使用路由系统匹配用户输入的URL的动作名和模块名。例如:
http://localhost/index.php/mymodule/myAction URL调用了index.php脚本(也就是前端控制器),他被理解为:动作-myAction,模块-mymodule |
前端控制器分发请求,他仅执行那些通用的和共同的代码,包括:
l 定义核心常量
l 定位symfony库
l 载入和初始化核心框架类
l 载入配置信息
l 解码请求URL,获取要执行的动作和请求参数
l 如果动作不存在则专项404错误
l 激活过滤器(比如,如果需要身份认证)
l 执行过滤器,第一次
l 执行动作,递交视图
l 执行过滤器,第二次
l 输出响应。
默认前端控制器叫作index.php,在项目的WEB/目录,他是一个简单的PHP文件,如下:
<?php define('SF_ROOT_DIR', realpath(dirname(__FILE__).'/..')); define('SF_APP', 'myapp'); define('SF_ENVIRONMENT', 'prod'); define('SF_DEBUG', false); require_once(SF_ROOT_DIR.DIRECTORY_SEPARATOR.'apps'.DIRECTORY_SEPARATOR.SF_APP.DIRECTORY_SEPARATOR.'config'.DIRECTORY_SEPARATOR.'config.php'); sfContext::getInstance()->getController()->dispatch(); |
这个文件在前面已经介绍过了:首先定义几个变量,然后引入应用的配置config.php,最后调用sfController(这是symfony MVC架构中的核心控制器对象)的dispatch()方法。最后一步将被过滤器链捕获。
每个环境存在一个前端控制器,环境定义在SF_ENVIRONMENT常量中。
创建新环境就和创建新的前端控制器一样简单,比如,你需要一个staging环境以使你的应用上线之前可以被客户测试。要创建staging环境,拷贝web/myapp_dev.php到web/myapp_staging.php,然后修改SF_ENVIRONMENT常量为staging。现在,你可以在所有的配置文件中增加staging段了设置新环境所需要的东西,看下面的示例:
## app.yml staging: mail: webmaster: dummy@mysite.com contact: dummy@mysite.com all: mail: webmaster: webmaster@mysite.com contact: contact@mysite.com |
##查看结果 http://localhost/myapp_staging.php/mymodule/index |
在命令行或者计划任务中访问symfony类和特性的时候需要使用批处理文件。批处理文件的开头与前端控制器的开头一样——除了前端控制器的分发部分不要。
<?php define('SF_ROOT_DIR', realpath(dirname(__FILE__).'/..')); define('SF_APP', 'myapp'); define('SF_ENVIRONMENT', 'prod'); define('SF_DEBUG', false); require_once(SF_ROOT_DIR.DIRECTORY_SEPARATOR.'apps'.DIRECTORY_SEPARATOR.SF_APP.DIRECTORY_SEPARATOR.'config'.DIRECTORY_SEPARATOR.'config.php'); // 添加批处理代码 |
动作是应用的心脏,因为他包含了所有应用的逻辑。他们使用模型并定义变量给视图。当在应用中使用一个请求,URL中定义了一个动作和请求的参数。
动作是moduleNameActions类(继承自sfActions类)中名为executeActionName的方法,以模块组织在一起,模块动作类存储在actions目录的actions.class.php文件中。
只有WEB目录下的文件能够被外部访问,前端控制脚本、图片、样式表和JS文件是公开的,即使PHP中方法不区分大小写,但symfony中区分,所以不要忘了动作方法必须以小写execute开始,紧跟着是首字母大写的动作名。 |
如果动作类变得很大,你应该做一些分解并把代码放在模型层,动作应该尽量的保证短小(几行最好),所有的业务逻辑都应该放在模型层中。
可以一个动作一个文件,文件的名称为动作名加Action.class.php,类名为动作名加Action,只是记得类继承自sfAction而非sfActions。
动作类提供了一种访问控制器相关信息与核心symfony对象的方法,下面演示了如何使用:
<?php define('SF_ROOT_DIR', realpath(dirname(__FILE__).'/..')); define('SF_APP', 'myapp'); define('SF_ENVIRONMENT', 'prod'); define('SF_DEBUG', false); require_once(SF_ROOT_DIR.DIRECTORY_SEPARATOR.'apps'.DIRECTORY_SEPARATOR.SF_APP.DIRECTORY_SEPARATOR.'config'.DIRECTORY_SEPARATOR.'config.php'); class mymoduleActions extends sfActions { public function executeIndex() { // Retrieving request parameters $password = $this->getRequestParameter('password'); // Retrieving controller information $moduleName = $this->getModuleName(); $actionName = $this->getActionName(); // Retrieving framework core objects $request = $this->getRequest(); $userSession = $this->getUser(); $response = $this->getResponse(); $controller = $this->getController(); $context = $this->getContext(); // Setting action variables to pass information to the template $this->setVar('foo', 'bar'); $this->foo = 'bar'; // Shorter version } } |
上下文: 在前端控制器中一个sfContext::getInstance()的调用。在动作中,getContext()方法是单例模式(即所有的调用都是第一个实例,这对于存储指向与给定请求相关的symfony核心对象的索引的情况是非常有用的)。 sfController:控制器对象 (->getController()) sfRequest:请求对象 (->getRequest()) sfResponse:响应对象 (->getResponse()) sfUser:用户Session对象 (->getUser()) sfDatabaseConnection:数据库链接
|