ginkgo\View

视图类

类摘要

namespace ginkgo;

class View {
  // 属性
  public $config   = array();
  public $replace  = array();

  protected static $instance;

  private $configThis = array(
   'type' => 'php',
  );

  private $obj_driver;
  private $data = array();

  // 方法
  public static instance( [ mixed $config = 'php', [ array $configTpl ]] ) : object
  public config( array $config )
  public driver( [ mixed $config = '', [ array $configTpl ]] ) : object
  public assign( mixed $assign [, mixed $value ] )
  public fetch( [ mixed $tpl [, mixed $assign [, mixed $value [, bool $is_display = false ]]]] ) : mixed
  public display( string $content [, mixed $assign [, mixed $value ]] ) : mixed
  public has( [ mixed $tpl ] ) : bool
  public setReplace( mixed $replace [, string $value ] )
  public setPath( string $pathTpl )
  public setObj( $name, &$obj )
  public getPath() : string
  public reset()

  protected __construct( [ mixed $config = '', [ array $configTpl ]] ) : object
  protected __clone()

  private replaceProcess( string $content ) : string
}

成员目录

$config 配置，$configThis 默认配置

public $config;
private $configThis;

结构

instance() 实例化方法

public static function instance( [ mixed $config = 'php', [ array $configTpl ]] ) : object

参数

• config 视图配置
• configTpl 模板配置

返回

• 本类的实例

config() 配置

public function config( array $config )

参数

• config 配置参数

返回

• 无

driver() 设置视图驱动

public function driver( [ mixed $config = '', [ array $configTpl ]] ) : object

参数

• config 视图配置
• configTpl 模板配置

返回

• 本类的实例

assign() 赋值

public function assign( mixed $assign [, mixed $value ] )

参数

• assign 变量，字符串或数组

  为数组时表示批量赋值

• value 值

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

返回

• 无

fetch() 渲染模板

public function fetch( [ mixed $tpl [, mixed $assign [, mixed $value [, bool $is_display = false ]]]] ) : mixed

参数

• tpl 模板

  支持如下几种写法：

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

• assign 变量，字符串或数组

  为数组时表示批量赋值

• value 值

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

• is_display 是否调用视图驱动的 display() 方法

返回

• 渲染结果

display() 渲染字符内容

public function display( string $content [, mixed $assign [, mixed $value ]] ) : mixed

参数

• content 字符内容，即模板内容

• assign 变量，字符串或数组

  为数组时表示批量赋值

• value 值

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

返回

• 渲染结果

has() 验证模板文件是否存在

public function has( [ mixed $tpl ] ) : bool

参数

• tpl 模板

  支持如下几种写法：

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

返回

• 布尔值

setReplace() 设置替换数据

public function setReplace( mixed $replace [, string $value ] )

参数

• replace 替换数据，字符串或数组

  为字符串时表示名称，为数组时表示批量设置

• value 值

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

返回

• 无

setPath() 设置模板路径

public function setPath( string $pathTpl )

参数

• pathTpl 模板路径

返回

• 无

setObj() 设置对象映射

public function setObj( $name, &$obj )

参数

• name 对象名称
• obj 对象映射

返回

• 无

getPath() 获取模板路径

public function getPath() : string

参数

• 无

返回

• 路径

reset() 重置模板数据

public function reset()

参数

• 无

返回

• 无

replaceProcess() 替换数据处理

private function replaceProcess( string $content ) : string

参数

• content 内容

返回

• 替换后的内容