documentation/manual/zh/module_specs/Zend_Controller-ActionHelpers-ViewRenderer.xml

   1 <sect3 id="zend.controller.actionhelpers.viewrenderer">
   2     <title>ViewRenderer</title>
   3
   4     <sect4 id="zend.controller.actionhelper.viewrenderer.introduction">
   5         <title>介绍</title>
   6
   7         <para>
   8            视图解析(<code>ViewRenderer</code>)助手为实现下列目标设计：
   9         </para>
  10
  11         <itemizedlist>
  12             <listitem>
  13                 <para>
  14                不需要在控制器内创建视图对象实例；视图对象将在控制器内自动注册。
  15                 </para>
  16             </listitem>
  17
  18             <listitem>
  19                 <para>
  20             根据当前的模块自动地设置视图脚本、助手、过滤器路径。指派当前的模块名为助手和过滤器类的类名前缀。
  21                 </para>
  22             </listitem>
  23
  24             <listitem>
  25                 <para>
  26             为所有分发的控制器和动作创建全局有效的视图对象。
  27                 </para>
  28             </listitem>
  29
  30             <listitem>
  31                 <para>
  32            允许开发人员为所有控制器设置默认的视图解析选项。
  33                 </para>
  34             </listitem>
  35
  36             <listitem>
  37                 <para>
  38             加入无需干预自动解析试图脚本的功能。
  39                 </para>
  40             </listitem>
  41
  42             <listitem>
  43                 <para>
  44            允许开发人员为视图基路径和视图脚本路径创建自己的规范。
  45                 </para>
  46             </listitem>
  47         </itemizedlist>
  48
  49         <note>
  50             <para>
  51         如果手动执行<code>_forward()</code>、<code>redirect</code>、或者<code>render</code>时，不会发生自动解析。因为执行这些动作时，等于告诉<code>ViewRenderer</code>，你要自己确定输出结果。
  52             </para>
  53         </note>
  54
  55         <note>
  56             <para>
  57         <code>ViewRenderer</code>助手默认启用。你可以通过前端控制器的<code>noViewRenderer</code>方法、设定参数(<code>$front->setParam('noViewRenderer', true)</code>)或者从助手经纪人栈(helper broker stack)中移除助手(<code>Zend_Controller_Action_HelperBroker::removeHelper('viewRenderer')</code>)等方式禁用该助手。
  58             </para>
  59
  60             <para>
  61         如希望在分发前端控制器前修改<code>ViewRenderer</code>设定，可采用下面的两种方法：
  62             </para>
  63
  64             <itemizedlist>
  65                 <listitem>
  66                     <para>
  67                创建实例并注册自己的<code>ViewRenderer</code>对象，然后传入到助手经纪人。
  68                     </para>
  69
  70                     <programlisting role="php"><![CDATA[
  71 $viewRenderer = new Zend_Controller_Action_Helper_ViewRenderer();
  72 $viewRenderer->setView($view)
  73              ->setViewSuffix('php');
  74 Zend_Controller_Action_HelperBroker::addHelper($viewRenderer);
  75 ]]>
  76                     </programlisting>
  77                 </listitem>
  78
  79                 <listitem>
  80                     <para>
  81                 通过助手经纪人即时的初始化并/或获取<code>ViewRenderer</code>对象。
  82                     </para>
  83
  84                     <programlisting role="php"><![CDATA[
  85 $viewRenderer = Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer');
  86 $viewRenderer->setView($view)
  87              ->setViewSuffix('php');
  88 ]]>
  89                     </programlisting>
  90                 </listitem>
  91             </itemizedlist>
  92         </note>
  93     </sect4>
  94
  95     <sect4 id="zend.controller.actionhelper.viewrenderer.api">
  96         <title>API</title>
  97
  98         <para>
  99             大多数使用中，只需要简单的创建 <code>ViewRenderer</code>对象，然后传入到动作助手经纪人。创建实例并注册的最简单方式是使用助手经纪人的<code>getStaticHelper()</code>方法：
 100         </para>
 101
 102         <programlisting role="php"><![CDATA[
 103 Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer');
 104 ]]>
 105         </programlisting>
 106
 107         <para>
 108             动作控制器第一次实例化时，会触发<code>ViewRenderer</code>创建一个视图对象。动作控制器每次实例化都会调用<code>ViewRenderer</code>的<code>init()</code>方法，设定动作控制器的视图属性，并以相对于当前模块的路径为参数调用<code>addScriptPath()</code>方法；调用时带有以当前模块命名的类前缀参数，该参数对为该模块定义的所有助手和过滤器类都有效。(this will be called with a class prefix named after the current module, effectively namespacing all helper and filter classes you define for the module. )
 109         </para>
 110
 111         <para>
 112             每次执行<code>postDispatch()</code>方法，它将为当前动作执行<code>render()</code>方法。
 113         </para>
 114
 115         <para>
 116             例如这个类：
 117         </para>
 118
 119         <programlisting role="php"><![CDATA[
 120 // A controller class, foo module:
 121 class Foo_BarController extends Zend_Controller_Action
 122 {
 123     // Render bar/index.phtml by default; no action required
 124     public function indexAction()
 125     {
 126     }
 127
 128     // Render bar/populate.phtml with variable 'foo' set to 'bar'.
 129     // Since view object defined at preDispatch(), it's already available.
 130     public function populateAction()
 131     {
 132         $this->view->foo = 'bar';
 133     }
 134 }
 135
 136 ...
 137
 138 // in one of your view scripts:
 139 $this->foo(); // call Foo_View_Helper_Foo::foo()
 140 ]]>
 141         </programlisting>
 142
 143         <para>
 144             <code>ViewRenderer</code>也定义了大量的访问器用来设定和获取视图选项。
 145         </para>
 146
 147         <itemizedlist>
 148             <listitem>
 149                 <para>
 150                     <code>setView($view)</code>可以为<code>ViewRenderer</code>设定视图对象。以公共类属性<code>$view</code>获取设定值。
 151                 </para>
 152             </listitem>
 153
 154             <listitem>
 155                 <para>
 156                     <code>setNeverRender($flag = true)</code>可以全局的启用或禁用自动解析，也就是对所有控制器都有效。如果设定为true，在所有控制器器内，<code>postDispatch()</code>将不会自动调用<code>render()</code>。<code>getNeverRender()</code>返回当前的设定值。
 157                 </para>
 158             </listitem>
 159
 160             <listitem>
 161                 <para>
 162                     <code>setNoRender($flag = true)</code> 用来启用或禁用自动解析，如果设置为true，在当前控制器内，<code>postDispatch()</code>不会调用<code>render()</code>方法。这个设定在<code>preDispatch()</code>每次执行时会被重置。<code>getNoRender()</code>返回当前的设定值。
 163                 </para>
 164             </listitem>
 165
 166             <listitem>
 167                 <para>
 168                    <code>setNoController($flag = true)</code>通知<code>render()</code>不要再到以控制器命名的子目录中寻找视图脚本。<code>getNoController()</code>返回当前值。
 169                 </para>
 170             </listitem>
 171
 172             <listitem>
 173                 <para>
 174                     <code>setNeverController($flag = true)</code>与<code>setNoController($flag = true)</code>相似，但是其在全局范围内有效——也就是说，它不会在每次分发动作时重置。<code>getNeverController()</code>返回当前值。
 175                 </para>
 176             </listitem>
 177
 178             <listitem>
 179                 <para>
 180                     <code>setScriptAction($name)</code>用来指定解析的视图脚本。<code>$name</code>是脚本的名字去掉后缀(不带控制器子目录，除非<code>noController</code>已开启)。如果没有指定，它将寻找以请求对象中的动作命名的视图脚本。<code>getScriptAction()</code>返回当前值。
 181                 </para>
 182             </listitem>
 183
 184             <listitem>
 185                 <para>
 186                     <code>setResponseSegment($name)</code>用来指定解析到响应对象中的哪个命名片段。如果没有指定，解析到默认片断。<code>getResponseSegment()</code>返回当前值。
 187                 </para>
 188             </listitem>
 189
 190             <listitem>
 191                 <para>
 192                     <code>initView($path, $prefix, $options)</code>可以指定视图的基路径，为助手和过滤器脚本设置类前缀，设定<code>ViewRenderer</code>选项。可以传入以下任意的标志：<code>neverRender</code>，<code>noRender</code>，<code>noController</code>， <code>scriptAction</code>，和<code>responseSegment</code>。
 193                 </para>
 194             </listitem>
 195
 196             <listitem>
 197                 <para>
 198                     <code>setRender($action = null, $name = null, $noController = false)</code>可以一次设定<code>scriptAction</code>、<code>responseSegment</code>和<code>noController</code>。  <code>direct()</code>是它的别名，使得控制器中可以方便的调用。
 199                 </para>
 200
 201                 <programlisting role="php"><![CDATA[
 202 // Render 'foo' instead of current action script
 203 $this->_helper->viewRenderer('foo');
 204
 205 // render form.phtml to the 'html' response segment, without using a
 206 // controller view script subdirectory:
 207 $this->_helper->viewRenderer('form', 'html', true);
 208 ]]>
 209                 </programlisting>
 210
 211                 <note><para>
 212                         <code>setRender()</code> 和 <code>direct()</code>并不会实际解析视图脚本，而是提示<code>postDispatch()</code>和<code>postDispatch()</code>解析视图。
 213                 </para></note>
 214             </listitem>
 215         </itemizedlist>
 216
 217         <para>
 218             构造函数允许可选的传入参数视图对象和<code>ViewRenderer</code>选项，接受与<code>initView()</code>一样的标志(flags)：
 219         </para>
 220
 221         <programlisting role="php"><![CDATA[
 222 $view    = new Zend_View(array('encoding' => 'UTF-8'));
 223 $options = array('noController' => true, 'neverRender' => true);
 224 $viewRenderer =
 225     new Zend_Controller_Action_Helper_ViewRenderer($view, $options);
 226 ]]>
 227         </programlisting>
 228
 229         <para>
 230             还有几个额外的方法用来定制路径规则，供确定视图基路径来增加视图对象，确定视图脚本路径查找并解析视图脚本时使用。这些方法每个都带有下面一个或更多的占位符(placehodlers)。
 231         </para>
 232
 233         <itemizedlist>
 234             <listitem>
 235                 <para>
 236                     <code>:moduleDir</code> 引用当前模块的基目录（常规的是模块的控制器目录的父目录）。
 237                 </para>
 238             </listitem>
 239
 240             <listitem>
 241                 <para>
 242                     <code>:module</code> 引用当前的模块名。
 243                 </para>
 244             </listitem>
 245
 246             <listitem>
 247                 <para>
 248                     <code>:controller</code> 引用当前的控制器名。
 249                 </para>
 250             </listitem>
 251
 252             <listitem>
 253                 <para>
 254                     <code>:action</code>引用当前的模块名。
 255                 </para>
 256             </listitem>
 257
 258             <listitem>
 259                 <para>
 260                     <code>:suffix</code> 引用当前的视图脚本后缀（可以通过<code>setViewSuffix()</code>来设置）。
 261                 </para>
 262             </listitem>
 263         </itemizedlist>
 264
 265         <para>
 266             控制器路径规则有关的方法:
 267         </para>
 268
 269         <itemizedlist>
 270             <listitem>
 271                 <para>
 272                     <code>setViewBasePathSpec($spec)</code>可以改变确定加入到视图对象的基路径的路径规则。默认规则是<code>:moduleDir/views</code>。任何时候都可以使用<code>getViewBasePathSpec()</code>获取当前的规则。
 273                 </para>
 274             </listitem>
 275
 276             <listitem>
 277                 <para>
 278                     <code>setViewScriptPathSpec($spec)</code>允许改变确定到达单独的视图脚本路径(去除试图脚本基路径)的路径规则。默认的路径规则是 <code>:controller/:action.:suffix</code>。任何时候都可以通过<code>getViewScriptPathSpec()</code>获取当前规则。
 279                 </para>
 280             </listitem>
 281
 282             <listitem>
 283                 <para>
 284                     <code>setViewScriptPathNoControllerSpec($spec)</code>允许改变 <code>noController</code>有效时确定到达单独的视图脚本路径(去除试图脚本基路径)的路径规则。默认的规则是<code>:action.:suffix</code>，任何时候都可以通过<code>getViewScriptPathNoControllerSpec()</code>获取当前规则。
 285                 </para>
 286             </listitem>
 287         </itemizedlist>
 288
 289         <para>
 290             为在路径规范之上精心设计的控制，可以使用<link linkend="zend.filter.inflector">Zend_Filter_Inflector</link>。深入地，<code>视图解析器（ViewRenderer）</code>已经使用inflector来执行路径映射。为和inflector互动 － 或者设置你自己的或者修改缺省的inflector，下面的方法可以被使用：
 291         </para>
 292
 293         <itemizedlist>
 294             <listitem>
 295                 <para>
 296                     <code>getInflector()</code> 将获取inflector。如果在<code>视图解析器</code>中不存在， 它用缺省的规则创建一个。
 297                 </para>
 298
 299                 <para>
 300                     缺省地，它用静态规则引用和静态目标做为后缀和模块目录；这允许不同的<code>视图解析器</code>具备动态修改inflector能力的属性。
 301                 </para>
 302             </listitem>
 303
 304             <listitem><para>
 305                     <code>setInflector($inflector, $reference)</code> 允许设置定制的inflector和<code>视图解析器</code>一起使用。如果<code>$reference</code> 是true，它将设置后缀和模块目录作为静态引用和目标给<code>视图解析器</code> 属性。
 306             </para></listitem>
 307         </itemizedlist>
 308
 309         <note>
 310             <title>缺省查找约定（Conventions）</title>
 311
 312             <para>
 313                 <code>视图解析器</code>做了一些路径标准化使视图脚本查找更容易。缺省规则如下：
 314             </para>
 315
 316             <itemizedlist>
 317                 <listitem>
 318                     <para>
 319                         <code>:module</code>: 混合词和驼峰词被短横线分开，并整个串变成小写。例如："FooBarBaz" 变成 "foo-bar-baz"。
 320                     </para>
 321
 322                     <para>
 323                         在内部，变形器（inflector） 使用过滤器<code>Zend_Filter_Word_CamelCaseToDash</code> 和 <code>Zend_Filter_StringToLower</code>。
 324                     </para>
 325                 </listitem>
 326
 327                 <listitem>
 328                     <para>
 329                         <code>:controller</code>: 混合词和驼峰词被短横线分开；下划线转换成目录分隔符，并且整个串变小写。例如："FooBar" becomes "foo-bar"; "FooBar_Admin" 变成 "foo-bar/admin".
 330                     </para>
 331
 332                     <para>
 333                         在内部，inflector 使用过滤器<code>Zend_Filter_Word_CamelCaseToDash</code>、<code>Zend_Filter_Word_UnderscoreToSeparator</code> 和 <code>Zend_Filter_StringToLower</code>。
 334                     </para>
 335                 </listitem>
 336
 337                 <listitem>
 338                     <para>
 339                         <code>:action</code>: 混合词和驼峰词被短横线分开；非字母数字字符翻译成短横线，并且整个串变成小写。 例如 "fooBar" 变成 "foo-bar"； "foo-barBaz" 变成 "foo-bar-baz"。
 340                     </para>
 341
 342                     <para>
 343                         在内部，inflector 使用过滤器 <code>Zend_Filter_Word_CamelCaseToDash</code>、<code>Zend_Filter_PregReplace</code> 和 <code>Zend_Filter_StringToLower</code>。
 344                     </para>
 345                 </listitem>
 346             </itemizedlist>
 347         </note>
 348
 349         <para>
 350             <code>视图解析器</code> API中的最后一项是关于实际确定视图脚本路径和解析视图的。包括：
 351         </para>
 352
 353         <itemizedlist>
 354             <listitem>
 355                 <para>
 356                     <code>renderScript($script, $name)</code>允许解析指定路径的脚本，可选的命名的路径片段。(<code>renderScript($script, $name)</code> allows you to render a script with a path you specify, optionally to a named path segment. )使用该方法时，<code>ViewRenderer</code>不会自动的确定脚本名称，而是直接的向视图对象的<code>render()</code>传入<code>$script</code>参数。
 357                 </para>
 358
 359                 <note><para>
 360                          当视图已经被解析到响应对象，将会设置<code>noRender</code>阻止相同的脚本被多次解析。
 361                 </para></note>
 362
 363                 <note>
 364                     <para>
 365                         默认的，<code>Zend_Controller_Action::renderScript()</code>代理<code>ViewRenderer</code>的<code>renderScript()</code>方法。
 366                     </para>
 367                 </note>
 368             </listitem>
 369
 370             <listitem>
 371                 <para>
 372                     <code>getViewScript($action, $vars)</code>基于传入的动作和/或<code>$vars</code>中的变量创建到视图脚本的路径。该数组中的键可以包含所有的路径指定键('moduleDir','module', 'controller', 'action', and 'suffix')。传入的任何变量都会优先使用，否则利用基于当前请求的值。
 373                 </para>
 374
 375                 <para>
 376                     <code>getViewScript()</code>根据<code>noController</code>标志的设定值使用<code>viewScriptPathSpec</code>或者<code>viewScriptPathNoControllerSpec</code>。
 377                 </para>
 378
 379                 <para>
 380                     模块、控制器以及动作中的单词定界符将后替换成短线('-')。因此，控制器名称'foo.bar'和动作'baz:bat'按照默认的路径规则将会得到视图脚本路径'foo-bar/baz-bat.phtml'。
 381                 </para>
 382
 383                 <note>
 384                     <para>
 385                         默认的，<code>Zend_Controller_Action::getViewScript()</code>代理<code>ViewRenderer</code>的<code>getViewScript()</code>方法。
 386                     </para>
 387                 </note>
 388             </listitem>
 389
 390             <listitem>
 391                 <para>
 392                     <code>render($action, $name, $noController)</code>首先检查<code>$name</code>或                  <code>$noController</code>参数是否传入，如果传入，则在ViewRenderer中设定相应的标志(分别是响应片段和noController)。然后传入<code>$action</code>参数到<code>getViewScript()</code>，最后传入计算的试图脚本路径到<code>renderScript()</code>。
 393                 </para>
 394
 395                 <note>
 396                     <para>
 397                         注意使用render()的边际效应：传入的响应片段名称和noController标志在视图对象中存留。此外解析结束后noRender会被设置。
 398                     </para>
 399                 </note>
 400
 401                 <note>
 402                     <para>
 403                         默认的，<code>Zend_Controller_Action::render()</code>代理 <code>ViewRenderer</code>的<code>render()</code>方法。
 404                     </para>
 405                 </note>
 406             </listitem>
 407
 408             <listitem>
 409                 <para>
 410                     <code>renderBySpec($action, $vars, $name)</code>允许传入路径规则变量以确定创建的视图脚本路径。它把<code>$action</code>和<code>$vars</code>传入到<code>getScriptPath()</code>，将脚本路径结果和<code>$name</code>传入到<code>renderScript()</code>。
 411                 </para>
 412             </listitem>
 413         </itemizedlist>
 414     </sect4>
 415
 416     <sect4 id="zend.controller.actionhelper.viewrenderer.basicusage">
 417         <title>基础用法示例</title>
 418
 419         <example id="zend.controller.actionhelper.viewrenderer.basicusage.example-1">
 420             <title>基本用法</title>
 421
 422             <para>
 423                 大多数基础使用中，只需在bootstrap中使用助手经纪人简单的初始化和注册<code>ViewRenderer</code> 助手，然后在动作方法中设置变量。
 424             </para>
 425
 426             <programlisting role="php"><![CDATA[
 427 // In your bootstrap:
 428 Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer');
 429
 430 ...
 431
 432 // 'foo' module, 'bar' controller:
 433 class Foo_BarController extends Zend_Controller_Action
 434 {
 435     // Render bar/index.phtml by default; no action required
 436     public function indexAction()
 437     {
 438     }
 439
 440     // Render bar/populate.phtml with variable 'foo' set to 'bar'.
 441     // Since view object defined at preDispatch(), it's already available.
 442     public function populateAction()
 443     {
 444         $this->view->foo = 'bar';
 445     }
 446
 447     // Renders nothing as it forwards to another action; the new action
 448     // will perform any rendering
 449     public function bazAction()
 450     {
 451         $this->_forward('index');
 452     }
 453
 454     // Renders nothing as it redirects to another location
 455     public function batAction()
 456     {
 457         $this->_redirect('/index');
 458     }
 459 }
 460 ]]>
 461             </programlisting>
 462         </example>
 463
 464         <note>
 465             <title>命名规则：控制器和动作名中的单词定界符</title>
 466             <para>
 467                 如果控制器或者动作名称由几个单词组成，分发器要求在URL中使用特定的路径和单词定界符分隔。<code>ViewRenderer</code>创建路径时将控制器名称中的任何路径定界符替换成实际的路径定界符('/')，任何单词定界符替换成短线('-')。对动作<code>/foo.bar/baz.bat</code>的调用将分发到<code>FooBarController.php</code>中的<code>FooBarController::bazBatAction()</code>，然后解析<code>foo-bar/baz-bat.phtml</code>；对动作<code>/bar_baz/baz-bat</code>的调用将分发到<code>Bar/BazController.php</code>中的<code>Bar_BazController::bazBatAction()</code>，并解析<code>bar/baz/baz-bat.phtml</code>。
 468             </para>
 469
 470             <para>
 471                 注意到在第二个例子中，模块依然是默认的模块，但由于路径分隔符的存在，控制器的接收到的名字为<code>Bar_BazController</code>，该类在文件<code>Bar/BazController.php</code>中。ViewRenderer模拟了控制器的目录分层。
 472             </para>
 473         </note>
 474
 475         <example id="zend.controller.actionhelper.viewrenderer.basicusage.example-2">
 476             <title>禁用自动解析</title>
 477
 478             <para>
 479                 对于某些动作和控制器，可能希望关闭自动解析——例如，如果想发送其他类型的输出（XML,JSON等），或者更简单的不想发送任何东西。有两个选项：关闭所有的自动解析(<code>setNeverRender()</code>)，或者仅仅关闭当前动作的自动解析(<code>setNoRender()</code>)。
 480             </para>
 481
 482             <programlisting role="php"><![CDATA[
 483 // Baz controller class, bar module:
 484 class Bar_BazController extends Zend_Controller_Action
 485 {
 486     public function fooAction()
 487     {
 488         // Don't auto render this action
 489         $this->_helper->viewRenderer->setNoRender();
 490     }
 491 }
 492
 493 // Bat controller class, bar module:
 494 class Bar_BatController extends Zend_Controller_Action
 495 {
 496     public function preDispatch()
 497     {
 498         // Never auto render this controller's actions
 499         $this->_helper->viewRenderer->setNoRender();
 500     }
 501 }
 502 ]]>
 503             </programlisting>
 504         </example>
 505
 506         <note>
 507             <para>
 508                大多数情况下，全局的关闭自动解析(<code>setNeverRender()</code>)没有意义，因为这样<code>ViewRenderer</code>做的唯一件事只是自动设置了视图对象。
 509             </para>
 510         </note>
 511
 512         <example id="zend.controller.actionhelper.viewrenderer.basicusage.example-3">
 513             <title>选择另外的视图脚本</title>
 514
 515             <para>
 516                 有些情况下需要解析另一个脚本而非以动作命名的脚本。例如，如果你有一个控制器包含增加和编辑两个动作，它们可能都显示相同的'form'视图，尽管拥有不同的值集合(value set)。只需要使用<code>setScriptAction()</code>或者<code>setRender()</code>简单的改变脚本的名称，或者以成员方法的形式调用助手，它将调用<code>setRender()</code>。
 517             </para>
 518
 519             <programlisting role="php"><![CDATA[
 520 // Bar controller class, foo module:
 521 class Foo_BarController extends Zend_Controller_Action
 522 {
 523     public function addAction()
 524     {
 525         // Render 'bar/form.phtml' instead of 'bar/add.phtml'
 526         $this->_helper->viewRenderer('form');
 527     }
 528
 529     public function editAction()
 530     {
 531         // Render 'bar/form.phtml' instead of 'bar/edit.phtml'
 532         $this->_helper->viewRenderer->setScriptAction('form');
 533     }
 534
 535     public function processAction()
 536     {
 537         // do some validation...
 538         if (!$valid) {
 539             // Render 'bar/form.phtml' instead of 'bar/process.phtml'
 540             $this->_helper->viewRenderer->setRender('form');
 541             return;
 542         }
 543
 544         // otherwise continue processing...
 545     }
 546
 547 }
 548 ]]>
 549             </programlisting>
 550         </example>
 551
 552         <example id="zend.controller.actionhelper.viewrenderer.basicusage.example-4">
 553             <title>修改注册的视图Modifying the registered view</title>
 554
 555             <para>
 556                 如果需要修改视图对象怎么办——例如改变助手路径或者编码？可以在控制器中修改视图对象设定，或者从<code>ViewRenderer</code>中抓取视图对象；两种方式引用的是同一个对象。
 557             </para>
 558
 559             <programlisting role="php"><![CDATA[
 560 // Bar controller class, foo module:
 561 class Foo_BarController extends Zend_Controller_Action
 562 {
 563     public function preDispatch()
 564     {
 565         // change view encoding
 566         $this->view->setEncoding('UTF-8');
 567     }
 568
 569     public function bazAction()
 570     {
 571         // Get view object and set escape callback to 'htmlspecialchars'
 572         $view = $this->_helper->viewRenderer->view;
 573         $view->setEscape('htmlspecialchars');
 574     }
 575 }
 576 ]]>
 577             </programlisting>
 578         </example>
 579     </sect4>
 580
 581     <sect4 id="zend.controller.actionhelper.viewrenderer.advancedusage">
 582         <title>高级用法示例</title>
 583
 584         <example id="zend.controller.actionhelper.viewrenderer.advancedusage.example-1">
 585             <title>修改路径规则</title>
 586
 587             <para>
 588                 有些情况下，默认的路径规则可能并不适合站点的需要。比如，希望拥有一个单独的模板树供设计人员访问（例如，如果你使用<ulink url="http://smarty.php.net/">Smarty</ulink>，这是很典型的情形）。这种情况下，你可能想硬编码视图的基路径规则，为动作视图脚本路径自身创建一套规则。
 589             </para>
 590
 591             <para>
 592                 假定视图的基路径(base path)为'/opt/vendor/templates',希望通过':moduleDir/:controller/:action.:suffix'引用视图脚本；如果设定了noController标志，想在顶级而不是在子目录中解析(':action.:suffix')。最终希望使用'tpl'作为视图脚本文件的后缀。
 593             </para>
 594
 595             <programlisting role="php"><![CDATA[
 596 /**
 597  * In your bootstrap:
 598  */
 599
 600 // Different view implementation
 601 $view = new ZF_Smarty();
 602
 603 $viewRenderer = new Zend_Controller_Action_Helper_ViewRenderer($view);
 604 $viewRenderer->setViewBasePathSpec('/opt/vendor/templates')
 605              ->setViewScriptPathSpec(':module/:controller/:action.:suffix')
 606              ->setViewScriptPathNoControllerSpec(':action.:suffix')
 607              ->setViewSuffix('tpl');
 608 Zend_Controller_Action_HelperBroker::addHelper($viewRenderer);
 609 ]]>
 610             </programlisting>
 611         </example>
 612
 613         <example id="zend.controller.actionhelper.viewrenderer.advancedusage.example-2">
 614             <title>一个动作中解析多个视图脚本</title>
 615
 616             <para>
 617                 有时可能需要在一个动作中解析多个视图脚本。这个非常简单，多次调用<code>render()</code>就行了：
 618             </para>
 619
 620             <programlisting role="php"><![CDATA[
 621 class SearchController extends Zend_Controller_Action
 622 {
 623     public function resultsAction()
 624     {
 625         // Assume $this->model is the current model
 626         $this->view->results =
 627             $this->model->find($this->_getParam('query', '');
 628
 629         // render() by default proxies to the ViewRenderer
 630         // Render first the search form and then the results
 631         $this->render('form');
 632         $this->render('results');
 633     }
 634
 635     public function formAction()
 636     {
 637         // do nothing; ViewRenderer autorenders the view script
 638     }
 639 }
 640 ]]>
 641             </programlisting>
 642         </example>
 643     </sect4>
 644 </sect3>
 645 <!--
 646 vim:se ts=4 sw=4 et:
 647 -->