Symfony控制层深入详解

发布时间：2020-05-25 14:29:06 所属栏目：PHP 来源：互联网

导读：这篇文章主要介绍了Symfony控制层,结合大量实例代码深入分析了Symfony控制器的常见使用技巧与相关注意事项,需要的朋友可以参考下

本文深入分析了Symfony控制层。分享给大家供大家参考，具体如下：

Symfony中控制层包含了连接业务逻辑与表现的代码，控制层为不同的使用分成了几个不同的部分。

1. 前端控制器是指向应用的唯一入口 2. 动作包含了应用的逻辑，他们检查请求的完整性并准备好表示层需要的数据 3. 请求、响应和Session对象提供访问请求参数、响应参数以及持久的用户数据，这些数据在控制层使用的很普遍 4. 过滤器是每个请求都要执行的代码的一部分，无论在动作前还是在动作后。可以自创过滤器。

前端控制器

所有WEB请求都将被前端控制器捕获，前端控制是给定环境下整个应用的唯一入口点。当前端控制接到一个请求，他使用路由系统匹配用户输入的URL的动作名和模块名。例如：

http://localhost/index.php/mymodule/myAction

URL调用了index.php脚本（也就是前端控制器），他被理解为：动作-myAction，模块-mymodule

前端控制器的工作细节

前端控制器分发请求，他仅执行那些通用的和共同的代码，包括：

1. 定义核心常量 2. 定位symfony库 3. 载入和初始化核心框架类 4. 载入配置信息 5. 解码请求URL，获取要执行的动作和请求参数 6. 如果动作不存在则专项404错误 7. 激活过滤器（比如，如果需要身份认证） 8. 执行过滤器，第一次 9. 执行动作，递交视图 10. 执行过滤器，第二次 11. 输出响应。

默认前端控制器

默认前端控制器叫作index.php，在项目的WEB/目录，他是一个简单的PHP文件，如下：

getController()->dispatch();

这个文件在前面已经介绍过了：首先定义几个变量，然后引入应用的配置config.php，最后调用sfController（这是symfony MVC架构中的核心控制器对象）的dispatch()方法。最后一步将被过滤器链捕获。

调用另一个前端控制器来更换环境

每个环境存在一个前端控制器，环境定义在SF_ENVIRONMENT常量中。

创建新环境就和创建新的前端控制器一样简单，比如，你需要一个staging环境以使你的应用上线之前可以被客户测试。要创建staging环境，拷贝web/myapp_dev.php到web/myapp_staging.php，然后修改SF_ENVIRONMENT常量为staging。现在，你可以在所有的配置文件中增加staging段了设置新环境所需要的东西，看下面的示例：

批处理文件

在命令行或者计划任务中访问symfony类和特性的时候需要使用批处理文件。批处理文件的开头与前端控制器的开头一样——除了前端控制器的分发部分不要。

动作（Actions）

动作是应用的心脏，因为他包含了所有应用的逻辑。他们使用模型并定义变量给视图。当在应用中使用一个请求，URL中定义了一个动作和请求的参数。

动作类

动作是moduleNameActions类（继承自sfActions类）中名为executeActionName的方法，以模块组织在一起，模块动作类存储在actions目录的actions.class.php文件中。

只有WEB目录下的文件能够被外部访问，前端控制脚本、图片、样式表和JS文件是公开的，即使PHP中方法不区分大小写，但symfony中区分，所以不要忘了动作方法必须以小写execute开始，紧跟着是首字母大写的动作名。

如果动作类变得很大，你应该做一些分解并把代码放在模型层，动作应该尽量的保证短小（几行最好），所有的业务逻辑都应该放在模型层中。

可选的动作类语法

可以一个动作一个文件，文件的名称为动作名加Action.class.php，类名为动作名加Action，只是记得类继承自sfAction而非sfActions。

在动作中获取信息

动作类提供了一种访问控制器相关信息与核心symfony对象的方法，下面演示了如何使用：

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：数据库链接 (->getDatabaseConnection()) sfLogger：日志对象 (->getLogger()) sfI18N：国际化对象(->getI18N()) 可以在代码的任何位置放置sfContext::getInstance()。

动作终止

当动作执行完成后会出现各种行为，动作方法的返回值决定视图如何被实施。sfView类的常量经常被指定与模板来显示动作的结果。如果一个默认视图被调用，动作应该以下面的代码结束：

Symfony将寻找actionNameSuccess.php的模板，这是默认的行为，所以如果你忽略了return语句，symfony也将查找actionNameSuccess.php模板，空动作也将触发同样的行为，如下：

如果要调用错误视图，动作将以下面语句结束：

调用自定义视图

如果动作不想调用模板（比如批处理和任务计划cron），可以使用下面的语句

上面情况下，视图层将被忽略，HTML代码可以直接在动作中输出，symfony提供了一个特殊的方法renderText()来实现。这种情况比较适用于AJAX交互。

Hello,World!"; return sfView::NONE; } // 等价方法 public function executeIndex() { return $this->renderText("Hello,World!"); }

有些时候你需要发送空的响应但包含定义的头信息（特别是X-JSON头），定义头通过sfResponse对象，并且放回sfView::HEADER_ONLY常量：

getResponse()->setHttpHeader("X-JSON",'('.$output.')'); return sfView::HEADER_ONLY; }

如果动作必须呈交特定模板，使用setTemplate()方法来忽略return语句：

setTemplate('myCustomTemplate');

跳向另一个动作

有些情况下，动作以请求一个新的动作作为结束，例如，一个动作处理表单的POST提交在更新数据库后通常会转向到另一个动作。另一个例子是动作别名：index动作经常是来完成显示，所以实际上是跳向了list动作。

有两种方式来实现另一个动作的执行：

① 向前（Forwards）方式

forward('otherModule','otherAction');

② 重定向（Redirection）方式

redirect('otherModule/otherAction'); $this->redirect('http://www.google.cn');

Forward和redirect后面的语句将不会被执行，你可以理解为他们等价于return语句。他们抛出sfStopException异常来停止动作的执行

两者的区别：forward是内部的处理，对用户是透明的，即用户不会感觉到动作发生了变化，URL也不会更改。相反，redirection是动作的真正跳转，URL的改变是最直接的反映。

如果动作是被POST提交表单调用的，你最好使用redirect。这样，如果用户刷新了结果页面，POST表单不会被重复提交；另外，后退按钮也能很好的返回到表单显示页面而不是一个警告窗口询问用户是否重新提交POST请求。

Forward404()方法是一种常用的特殊forward，他跳到“页面无法找到”动作。

经验说明，很多时候一个动作会在验证一些东西后redirect或者forward另一个动作。这就是为什么sfActions类有很多的方法命名为forwardIf(),forwardUnless(),forward404If(),forward404Unless(),redirectIf(),和 redirectUnless()，这些方法简单地使用一个测试结果参数true（那些xxxIf()方法）或false（那些xxxUnless()方法）：

getRequestParameter('id')); $this->forward404If(!$article); } public function executeShow() { $article = ArticlePeer::retrieveByPK($this->getRequestParameter('id')); $this->forward404Unless($article); }

这些方法不仅仅是减少你的代码行数，他们还使得你的程序更加易读。

当动作调用forward404()或者其他类似方法，symfony抛出管理404响应的sfError404Exception异常，也就是说如果你想显示404信息，你无需访问控制器，你只是抛出这个异常即可。

模块中多个动作重复代码的处理方式

（编辑：安卓应用网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!