详细介绍php Zend Framework中的render使用方法

http://www.pkphp.com/2010/01/09/zend-framework-render-intro/

通常在我们利用ZF实现php的mvc时,最关键的地方当然是Controller类的各种action方法,在action方法中,我们确定及输出内容. 在类 abstract class Zend_Controller_Action 中的dispatch方法你可以发现这一行 $this->$action();

那么如何确定及输出内容呢,就是进行render了,不过这个render却是有好几个的,下面列出这几个情形
<?php
class IndexController extends Zend_Controller_Action
{
 public function contactAction()
 {
 //$this->render(“index”);
 //$this->render();
 //$this->renderScript(“sidebar.phtml”);


 //$this->_helper->viewRenderer(“sidebar”);

 //$this->view->render(“sidebar.phtml”);
 //$this->view(“sidebar”);

 }
}
?>

总结下来,似乎就是这三中render了(欢迎补充)

1.自身render

先看第一种
//$this->render(“index”);
//$this->render();
//$this->renderScript(“sidebar.phtml”);
这是直接使用Zend_Controller_Action类的render方法
第一句是render了另一个action所对应的视图(看清了 是render那个action对应的视图 而不是执行那个action!)
第二句式render本action对应的视图,这个有什么意义呢(因为很多情形你看不到这个写法的),这个下面再说.
第三句是render特定的视图文件,这里你可能认为前两个方法实际是调用了这个renderScript,其实不是如此.
下面就阐述一下.顺便解释第二句的原因.
Zend_Controller_Action类的render方法中其实是有两个分支的 如下render函数代码
public function render($action = null, $name = null, $noController = false)
{
if (!$this->getInvokeArg(‘noViewRenderer‘) && $this->_helper->hasHelper(‘viewRenderer‘)) {
return $this->_helper->viewRenderer->render($action, $name, $noController);
}

$view = $this->initView();
$script = $this->getViewScript($action, $noController);

 $this->getResponse()->appendBody(
 $view->render($script),
 $name
 );
 }
可以看到一种情形是利用(代理)了视图助手类(viewRenderer)的render方法
另一种是禁用助手时的情形 就得亲自上阵了,这也就是render()出现的原因,你禁用了视图助手后要输出本action对应视图内容可以使用render()来完成

2.通过视图助手viewRenderer

上面说起了视图助手,那我们来看action中的第二个片段,正是借助视图助手来进行
//$this->_helper->viewRenderer(“sidebar”);
实际上这里这句话并不是render内容,而是指定了要render哪个视图,参考Zend_Controller_Action_Helper_ViewRenderer类的这个函数
 public function direct($action = null, $name = null, $noController = null)
 {
 $this->setRender($action, $name, $noController);
 }
那么输出呢 是怎么输出的?
可以在$this->_helper->viewRenderer(“sidebar”); 后直接调用$this->render();即可.
但是实际上你完全不用调用,只写那一句就行.
你不写render的时候,视图助手会来替你完成.在Zend_Controller_Action类中的dispatch方法中有这么一句
$this->_helper->notifyPostDispatch();
_helper是什么? 是一个Zend_Controller_Action_HelperBroker类 ,其中有这个方法
 public function notifyPostDispatch()
 {
 foreach (self::getStack() as $helper) {
 $helper->postDispatch();
 }
 }

可以看到调用了其中各个助手的postDispatch();
而viewRenderer正是其中的一个助手,其postDispatch方法如下
public function postDispatch()
{
if ($this->_shouldRender()) {
$this->render();
}
}
正是在这里视图助手帮你进行了render,如果你自己render了,聪明的视图助手会知晓的,可以查看下在_shouldRender()中的这个 $this->getRequest()->isDispatched(),及Zend_Controller_Front 类中dispatch方法的这句话:$this->_request->setDispatched(true);

3.终极render 关于Zend_View->render()

好了现在我们来看看Zend_View的render().
在上面的两个中我们都说到了render(),比如action的render和视图助手的render
那么你该问个问题:就这样了?后面呢?
后面的才是关键的.
在action的render中,你可能注意到这句话了
 $this->getResponse()->appendBody(
 $view->render($script),
 $name
 );
而我们再看看viewRenderer的render(),viewRenderer的render方法其实是调用了renderScript方法,代码如下
 public function renderScript($script, $name = null)
 {
 if (null === $name) {
 $name = $this->getResponseSegment();
 }

 $this->getResponse()->appendBody(
 $this->view->render($script),
 $name
 );

 $this->setNoRender();
 }
可以看到这里跟action的render有点类似,也有同样的那句话.
就是说action的render和viewRenderer的render其实都是调用Zend_View的render,拿到内容而后置放到response中

Zend_View的render:
 public function render($name)
 {
 // find the script file name using the parent private method
 $this->_file = $this->_script($name);
 unset($name); // remove $name from local scope

 ob_start();
 $this->_run($this->_file);

 return $this->_filter(ob_get_clean()); // filter output
 }

至于run:
protected function _run()
{
if ($this->_useViewStream && $this->useStreamWrapper()) {
include ‘zend.view://‘ . func_get_arg(0);
} else {
include func_get_arg(0);
}
}

那么你就明白了最开始代码中的第13行
13 //$this->view->render(“sidebar.phtml”);
其实是个幌子,哈.这句话只是得到了内容,但是呢 没做处理!
所以我们应该这样
13 echo $this->view->render(“sidebar.phtml”);
再然后呢?参看Zend_Controller_Front类dispatch
$this->_response->sendResponse();
及Zend_Controller_Response_Abstract类
public function outputBody()
{
foreach ($this->_body as $content) {
echo $content;
}
}

而至于第14行
14 //$this->view(“sidebar”);
貌似合理,瞪一眼就知道了:这句话地地道道的错误
action 中没有这个方法,__call中也没有相应处理,不象_helper->viewRenderer(“sidebar”);在 _helper针对该情况在__call中有相应处理
 public function __call($method, $args)
 {
 $helper = $this->getHelper($method);
 if (!method_exists($helper, ‘direct‘)) {
 require_once ‘Zend/Controller/Action/Exception.php‘;
 throw new Zend_Controller_Action_Exception(‘Helper ”‘ . $method .‘“ does not support overloading via direct()‘);
 }
 return call_user_func_array(array($helper, ‘direct‘), $args);
 }
没有viewRenderer这个方法,于是去寻找名为viewRenderer并且有direct方法的助手,找到了即执行这个direct方法(上面第二部分贴过代码了)
至于viewRenderer这个助手存放时,要注意到他的名字是死的 就是”viewRenderer”,具体看Zend_Controller_Action_Helper_Abstract类的getName方法
 public function getName()
 {
 $full_class_name = get_class($this);

 if (strpos($full_class_name, ‘_‘) !== false) {
 $helper_name = strrchr($full_class_name, ‘_‘);
 return ltrim($helper_name, ‘_‘);
 } else {
 return $full_class_name;
 }
 }
之所以提到这点是因为在Zend_Controller_Action_Helper_ViewRenderer注释中你能看到这句话
// In your action controller methods:
$viewHelper = $this->_helper->getHelper(‘view’);
而实际上你复制这句话到your action controller methods中去 只会出错
Exception information:

Message: Action Helper by name View not found

个人感觉php Zend Framework还是很不错,虽然一直没搞好调试器
但是非常满意于可以随处置放var_dump