以下是不常见的几个助手,知道其基本用法就可以了,用到的时候在具体查看即可。
ActionStack 用于操作动作堆栈。
ContextSwitch 和 AjaxContext 为你的动作提供替代响应格式;
ActionStack
动作堆栈助手允许把请求压到动作堆栈前端控制器插件,有效地帮助你在请求期间创建一个动作队列来执行。(动作堆栈)助手允许你通过指定新的请求对象或通过“动作/控制器/模块”集合来添加动作。
Note: 调用动作堆栈助手来初始化动作堆栈插件
调用动作堆栈 助手暗中注册动作堆栈 插件 -- 这就意味着你不需要显性地注册动作堆栈 插件来用这个功能。
Example #1 用动作、控制器和模块名来添加一个任务
经常地,仅仅指定动作、控制器和模块(和可选的参数)最简单,和调用Zend_Controller_Action::_forward()一样:
class FooController extends Zend_Controller_Action{ public function barAction() { // Add two actions to the stack // Add call to /foo/baz/bar/baz // (FooController::bazAction() with request var bar == baz) $this->_helper->actionStack('baz', 'foo', 'default', array('bar' => 'baz')); // Add call to /bar/bat // (BarController::batAction()) $this->_helper->actionStack('bat', 'bar'); }} Example #2 使用请求对象添加一个任务有时候请求对象的OOP本性很有用;你也可以传递这样一个对象给动作堆栈助手。 class FooController extends Zend_Controller_Action{ public function barAction() { // Add two actions to the stack // Add call to /foo/baz/bar/baz // (FooController::bazAction() with request var bar == baz) $request = clone $this->getRequest(); // Don't set controller or module; use current values $request->setActionName('baz') ->setParams(array('bar' => 'baz')); $this->_helper->actionStack($request); // Add call to /bar/bat // (BarController::batAction()) $request = clone $this->getRequest(); // don't set module; use current value $request->setActionName('bat') ->setControllerName('bar'); $this->_helper->actionStack($request); }}
ContextSwitch and AjaxContext
ContextSwitch 动作助手用来使在请求后返回不同的响应格式变得容易。AjaxContext 助手是 ContextSwitch 的特别版本,用来返回响应到 XmlHttpRequests。
你必须在关于动作能够响应哪个上下文(context)的控制器中打开(enable)其中一个。如果一个进来的请求对给定的动作指出一个有效的上下文,助手将做:
如果布局被打开,则关闭它。
设置一个备用的视图后缀,为上下文有效地请求一个分离的视图脚本。
为期望的上下文发送适当的响应头。
可选地调用特别的回调(callback)来设置上下文和/或执行处理后的任务。
例子,考虑下列的控制器:
class NewsController extends Zend_Controller_Action{ /** * Landing page; forwards to listAction() */ public function indexAction() { $this->_forward('list'); } /** * List news items */ public function listAction() { } /** * View a news item */ public function viewAction() { }}
我们想让 listAction() 也支持 XML 格式,不用创建一个不同的动作,我们可以提示它可以返回 XML 响应:
class NewsController extends Zend_Controller_Action{ public function init() { $contextSwitch = $this->_helper->getHelper('contextSwitch'); $contextSwitch->addActionContext('list', 'xml') ->initContext(); } // ...}
这将完成:
设置 'Content-Type' 响应头为 'text/xml'.
修改视图后缀为 'xml.phtml' (或者,如果你使用另外的视图后缀,'xml.[你的后缀]')。
现在你需要创建一个新的视图脚本 'news/list.xml.phtml',它将创建和解析 XML。
为决定一个请求是否应该初始化一个上下文开关(context switch),这个助手检查在请求对象理的令牌。缺省地,它寻找一个 'format' 参数,尽管这是可配置的。这意味着,在大多数情况下,为触发一个上下文开关,你可以添加一个 'format' 参数给你的请求:
通过 URL 参数:/news/list/format/xml (回忆一下,缺省路由模式(schema)允许在动作后跟随任意的键/值对)
通过 GET 参数:/news/list?format=xml
ContextSwitch 允许指定任意的上下文,包括需要修改后缀的、任何应该被发送的响应头和任意的用来初始化和善后的回调(callback)。
缺省可用的上下文
缺省地,ContextSwitch 助手的两个上下文可用:json 和 xml。
JSON. JSON 上下文设置 'Content-Type' 响应头为 'application/json',设置视图脚本后缀为 'json.phtml'。
缺省地,不需要视图脚本,它将系列化所有的视图变量,立即发出 JSON 响应。
通过关闭 auto-JSON serialization 可禁止这个行为:
$this->_helper->contextSwitch()->setAutoJsonSerialization(false);
XML. XML 上下文设置 'Content-Type' 响应头为 'text/xml',设置视图脚本后缀为 'xml.phtml'。你需要为这个上下文创建新的视图脚本。
创建定制的上下文
有时候,缺省的上下文不够用,例如你需要返回 YAML,或系列化 PHP、RSS 或 ATOM feed 等等,ContextSwitch 正是你需要的东西。
最容易的添加新的上下文的办法是通过 addContext() 方法。这个方法带有两个参数:上下文的名称和一个规范(specification)数组,规范应当包含下列中的一个或多个:
suffix: 当在视图解析器里注册时,预先准备的缺省的视图后缀。
headers: 作为响应的一部分发送的头/值(header/value)对的数组。
callbacks: 数组,包含一个或更多键 'init' 或 'post',指向有效的可用于上下文和善后处理的 PHP 回调(callback)。
回调的初始化发生在当 ContextSwitch 检测到上下文时,你可以用它来执行任意的应该发生的逻辑。作为例子,当 auto-JSON serialization 是 on 的时候,JSON 上下文使用回调来关闭视图解析器(ViewRenderer)。
善后处理(post processing)发生在动作的 postDispatch() 程序期间,可用来执行任意的逻辑。作为例子,JSON 上下文使用回调(callback)来决定是否 auto-JSON serialization 是 on;如果是,它系列化视图变量到 JSON 和 发送响应,如果不是,它重新打开(re-enable)视图解析器(ViewRenderer)。
和上下文交互作用的方法:
addContext($context, array $spec): 添加新的上下文,如果上下文存在,抛出一个异常。
setContext($context, array $spec): 添加新的上下文或重写一个已存在的上下文,和 addContext() 使用相同的规范(specification)。
addContexts(array $contexts): 一次添加多个上下文。$contexts 应当是上下文/规范(context/specification)对的数组。如果任何一个上下文存在,就抛出异常。
setContexts(array $contexts): 添加和重写存在的上下文(多于一个),和 addContexts() 使用相同的规范。
hasContext($context): 如果上下文存在,返回 true,否则返回 false。
getContext($context): 通过名称来获取一个单个的上下文,返回一个遵循用于 addContext() 的规范的数组。
getContexts(): 获取所有的上下文,返回上下文/规范对的数组。
removeContext($context): 通过名称来清除一个单个的上下文,成功返回 true,如果没有发现上下文返回 false。
clearContexts(): 清除所有上下文。
为每个动作设置上下文
有两个设置可用的上下文的机制:或者在控制器里手工创建数组,或者使用在 ContextSwitch 里的方法来装配它们。
添加动作/上下文关系的基本方法是 addActionContext() 。它有两个参数:上下文被添加到的动作和上下文的名称或上下文数组的其中之一。作为例子,考虑下列的控制器类:
class FooController extends Zend_Controller_Action{ public function listAction() { } public function viewAction() { } public function commentsAction() { } public function updateAction() { }}
假如我们想添加 XML 上下文到 'list'动作、XML 和 JSON 上下文到 'comments' 动作,可以在 init() 方法中完成:
class FooController extends Zend_Controller_Action{ public function init() { $this->_helper->contextSwitch() ->addActionContext('list', 'xml') ->addActionContext('comments', array('xml', 'json')) ->initContext(); }}
另外,还可以定义数组属性 $contexts:
class FooController extends Zend_Controller_Action{ public $contexts = array( 'list' => array('xml'), 'comments' => array('xml', 'json') ); public function init() { $this->_helper->contextSwitch()->initContext(); }}
上述不但缺少周密考虑,而且有潜在的错误。
下面的方法可用来构造上下文映射:
addActionContext($action, $context): 标记一个或多个可用的上下文给一个动作,如果映射已经存在,就追加到那些映射中。$context 可以是一个单个的上下文,或者是一个上下文数组。
一个上下文的 true 值将标记所有可用的上下文给动作。
一个 $context 的空值将关闭(disable)所有给定动作的上下文。
setActionContext($action, $context): 标记一个或多个上下文对动作可用,如果映射已经存在,它就替换它们。$context 可以是一个单个的上下文,或者是一个上下文数组。
addActionContexts(array $contexts): 一次性添加若干动作/上下文对,$contexts 是动作/上下文对的关联数组。它代理 addActionContext(),意味着如果那些动作/上下文对存在,就追加之。
setActionContexts(array $contexts): 和 addActionContexts() 一样,但重写已存在的动作/上下文对。
hasActionContext($action, $context): 决定一个特定的动作是否有一个给定的上下文。
getActionContexts($action = null): 返回或者给定动作的所有上下文,或者所有动作/上下文对。
removeActionContext($action, $context): 从给定动作中清除一个或多个上下文。$context 可以是一个单个的上下文,或者是一个上下文数组。
clearActionContexts($action = null): 从给定动作或者从有上下文的动作中清除所有上下文。
初始化上下文开关
为初始化上下文开关,需要在动作控制器中调用 initContext():
class NewsController extends Zend_Controller_Action{ public function init() { $this->_helper->contextSwitch()->initContext(); }}
在某些情况下,你想强制使用上下文,例如,如果上下文开关是激活状态,你只想用 XML 上下文,可以通过传递上下文给 initContext() 来完成:
$contextSwitch->initContext('xml');
另外的功能
用来改变 ContextSwitch 助手行为的方法包括:
setAutoJsonSerialization($flag): 缺省地,JSON 上下文将系列化任何视图变量给 JSON 符号并把它作为响应返回。如果想创建自己的响应,你需要关闭它,这需要在调用 initContext() 之前来完成。
$contextSwitch->setAutoJsonSerialization(false);
$contextSwitch->initContext();
用 getAutoJsonSerialization() 来获取 flag 的值。
setSuffix($context, $suffix, $prependViewRendererSuffix): 用这个方法,你可以为给定的上下文指定一个不同的后缀。第三个参数用来指示是否用新的后缀预先准备当前视图解析器,这个 flag 缺省为打开。
传递空值给后缀将导致只有视图解析器的后缀被使用。
addHeader($context, $header, $content): 为给定的上下文添加一个响应头,$header 是头的名称,$content 是为这个头传递的值。
每个上下文可以有多个头,addHeader() 把另外的头添加到头的堆栈。
如果为上下文指定的 $header 已经存在,就抛出一个异常。
setHeader($context, $header, $content): setHeader() 和 addHeader() 一样,但它允许重写已经存在的上下文的头。
addHeaders($context, array $headers): 一次性添加多个头到给定的上下文,代理 addHeader(),如果头已经存在,将抛出异常。$headers 是一个头/上下文对的数组。
setHeaders($context, array $headers.): 象 addHeaders() 一样,但代理 setHeader(),允许重写已存在的头。
getHeader($context, $header): 获取给定上下文的头的值,如果没有发现返回 null。
removeHeader($context, $header): 清除一个单个的给定上下文的头。
clearHeaders($context, $header): 清除所有给定上下文的头。
setCallback($context, $trigger, $callback): 为给定的上下文在给定的触发器设置回调(callback),触发器或者是 'init',或者是 'post'(指明回调将被在上下文初始化时或者派遣后(postDispatch)调用)。 $callback 应当是一个有效的 PHP 回调。
setCallbacks($context, array $callbacks): 为给定的上下文设置多个回调,$callbacks 应当是触发器/回调对。事实上,最常用的可注册的回调有两个:一个为初始化用的,一个是做善后处理。
getCallback($context, $trigger): 在给定的上下文中从给定的触发器中获取一个回调。
getCallbacks($context): 从给定的上下文获取所有的回调,返回一个触发器/回调对数组。
removeCallback($context, $trigger): 从给定的触发器和上下文清除一个回调。
clearCallbacks($context): 为给定的上下文清除所有的回调。
setContextParam($name): 设置请求参数来检查什么时候决定上下文开关是否已经请求,缺省值为 'format',但这个访问器可以用来设置一个备用的值。
getContextParam() 用来获取当前的值。
setAutoDisableLayout($flag): 缺省地,当上下文开关出现,布局是关闭的;这是因为一般布局将只用来返回正常的相应,对备用的(alternate)上下文没有意义。然而,如果想使用布局(也许你对新的上下文有个布局),你可以通过传递一个 false 的值给 setAutoDisableLayout() 来改变它的行为。这应当 在 调用 initContext() 之前 来做。
用访问器 getAutoDisableLayout() 来获取这个 flag 的值。
getCurrentContext() 可用来确定什么上下文被检测到,如果有的话。如果没有上下文开关发生,或者在调用 initContext() 之前调用它,则返回 null。
AjaxContext 函数
AjaxContext 助手继承 ContextSwitch,所有 ContextSwitch 函数列表对它也有效,只是有些小小的不同。
首先,它为确定上下文使用不同的动作控制器属性 - $ajaxable。这样你就可以对 AJAX 和 普通的 HTTP 请求使用不同的上下文。AjaxContext 的各种各样 *ActionContext*() 方法将写到这个属性。
其次,由请求对象的 isXmlHttpRequest() 方法来确定,它只有在 XmlHttpRequest 出现后才触发。这样,如果上下文参数 ('format')在请求中传递,但请求没有做成 XmlHttpRequest,不会触发上下文开关。
第三,AjaxContext 添加另外的上下文 - HTML。在这个上下文中,为了区别这个上下文和普通的请求,它设置后缀为 'ajax.phtml'。没有另外的头返回。
Example #4 允许动作响应 Ajax 的请求
在下面的例子中,我们允许对动作 'view'、 'form' 和 'process' 的请求响应 AJAX 的请求。在头两个例子 'view' 和 'form',返回不更新页面的 HTML 片段;在最后的例子,返回 JSON。
class CommentController extends Zend_Controller_Action{ public function init() { $ajaxContext = $this->_helper->getHelper('AjaxContext'); $ajaxContext->addActionContext('view', 'html') ->addActionContext('form', 'html') ->addActionContext('process', 'json') ->initContext(); } public function viewAction() { // Pull a single comment to view. // When AjaxContext detected, uses the comment/view.ajax.phtml // view script. } public function formAction() { // Render the "add new comment" form. // When AjaxContext detected, uses the comment/form.ajax.phtml // view script. } public function processAction() { // Process a new comment // Return the results as JSON; simply assign the results as // view variables, and JSON will be returned. }}
在客户端,AJAX 库将请求终点 '/comment/view'、 '/comment/form' 和 '/comment/process',并传递 'format' 参数:'/comment/view/format/html'、'/comment/form/format/html' 和 '/comment/process/format/json'。(或者你可以通过查询字符串( query string) 传递参数,如:"?format=json")
假定你的库传递 'X-Requested-With:XmlHttpRequest'头,这些动作将返回适当的响应格式。