渲染

因为控制器可以无需继承任何基础类，因此在控制器中如何使用视图取决于你怎么定义控制器。

渲染模板最常用的方法是控制器继承 ginkgo\Ctrl 类后调用 fetch() 方法：

fetch() 方法说明

function fetch( [ $tpl = '' [, $assign = '' [, $value = '' ]]] )

参数

• tpl 模板

  支持如下几种写法：

  用法	描述	规则
  不带任何参数	自动定位	app/tpl/当前模块/当前控制器/当前动作.tpl.php
  动作	常用写法	app/tpl/当前模块/当前控制器/动作.tpl.php
  控制器/动作	常用写法	app/tpl/当前模块/控制器/动作.tpl.php
  完整的模板路径	必须包含模板后缀	模板后缀必须与配置一致，详情请查看 配置 -> 常量配置

• assign 变量

  支持两种类型：为字符串时表示变量名，为数组时表示批量传输

• value 变量值

  当 assign 为字符串时为必须，当 assign 为数组时自动忽略。

下面是一个最典型的用法，不带任何参数：

namespace app\ctrl\index;

use ginkgo\Ctrl;

class Index extends Ctrl {

  public function index() {
    // 不带任何参数 自动定位当前动作的模板文件
    return $this->fetch();
  }

}

文件名为实际动作的小写和下划线，如：

namespace app\ctrl\index;

use ginkgo\Ctrl;

class Index extends Ctrl {

  public function cateList() {
    return $this->fetch();
  }

}

模板的文件名为

cate_list.tpl.php

模板的实际位置是

app/tpl/index/index/cate_list.tpl.php

如果没有按照定义规则来定义模板（或者需要调用其他模板），可以使用：

// 指定模板输出
return $this->fetch('edit');

表示调用当前控制器下面的 edit 模板

return $this->fetch('member/read');

表示调用 Member 控制器下面的 read 模板。

跨模块渲染模板及自定义模板路径

渲染输出不需要写模板的路径和后缀。这里的控制器和动作并不一定需要有实际对应的控制器和动作，只是一个目录名称和文件名称而已，例如，你的项目里面可能根本没有 Public 控制器，更没有 Public 控制器的 menu 动作，但是一样可以使用

return $this->fetch('public/menu');

输出这个模板文件。理解了这个，模板输出就清晰了。

支持从设置的根目录开始读取模板，以下是默认设置下的例子：

return $this->fetch('/menu');

表示读取的模板是

app/tpl/当前模块/menu.tpl.php

如果需要调用视图类 ginkgo\View 的其它方法，可以直接使用 $this->obj_view 对象。

如果你的模板位置比较特殊或者需要自定义模板的位置，可以通过写入完整模板路径、调用 ginkgo\View 的 setPath 方法或者修改配置来实现。

自动定位

namespace app\ctrl\index;

use ginkgo\Ctrl;

class Index extends Ctrl {

  public function cateList() {
    return $this->fetch();
  }

}

明确写入模板路径和后缀

return $this->fetch('/web/app/tpl/index/index/cate_list.tpl.php');

调用 setPath() 方法

$this->obj_view->setPath('/web/app/tpl/index/');

return $this->fetch('index/cate_list');

以上方式的效果是一致的。

模板配置的 path 参数支持完整路径定义，默认采用 app/tpl/ 作为模板目录

'tpl' => array(
  'path'   => 'default', // 定义模板目录
  ...
);

模板的实际目录是

app/tpl/default/

'tpl' => array(
  'path'   => '/web/app/tpl/', // 定义模板根目录
  ...
);

模板的实际目录是

/web/app/tpl/

渲染内容

如果希望直接解析内容而不通过模板文件的话，可以使用 display() 方法：

namespace app\ctrl\index;

use ginkgo\Ctrl;

class Index extends Ctrl {

  public function index() {
    // 直接渲染内容
    $content = '\<?php echo $name; ?\> - \<?php echo $email; ?\>';
    $data = array(
      'name'  => 'ginkgo',
      'email' => 'ginkgo@qq.com'
    );
    return $this->display($content, $data);
  }
}