FizeView参考手册¶

欢迎使用
安装说明
更新日志
许可协议
捐赠我们
模板引擎配置
类库参考

欢迎使用 ¶

欢迎使用¶

FizeView 是一个支持各种引擎的视图库。

FizeView 没有再新建一个视图语法，它认为没有这个必要！

世面已经有那么多性能不错，满足各类需求的视图框架了，为什么我们还需要 FizeView ？

因为 FizeView 允许你使用任意的视图引擎，但是又使用相同的视图接口，这样的好处很明显：你可以随意选择自己擅长的视图引擎来编写前端代码。

FizeView 有非常完善的参考文档，且其功能追求简洁明了，相信您会喜欢上这样的视图库。

处理器支持¶

目前 FizeView 已支持的模板视图引擎处理器如下：

Blade : Laravel 提供的一个简单而又强大的模板引擎。
Php : PHP 原生模板引擎。
Smarty : 一个历史悠久，经久耐用的模板引擎。
Think : 即 ThinkTemplate ，ThinkPHP 的内置模板引擎。
Twig : 一个流行、严谨的模板引擎，多个 IDE 都对 Twig 进行高亮支持。

入门三部曲¶

1.配置参数¶

根据参数配置进行FizeView 配置。

2.设置默认模板引擎或者设置新模板引擎¶

使用 new View($handler, $config);`进行默认模板引擎设置，或者 `View::getInstance($handler, $config) 方法获取新模板引擎实例

3.进行模板编写即其他操作¶

FizeView 简化了模板的操作，日常您使用的方法如下。

View::engine() : 获取底部引擎对象。
View::path() : 设置模板路径。
View::assign() : 变量赋值。
View::render() : 返回渲染内容。
View::display() : 显示渲染内容。

入门示例¶

use fize\view\View;

$config = [
        'path'   => '../view',
        'cache' => '../runtime',
        'debug'  => true
];
new View('Twig', $config);  //使用 twig 引擎

$assigns = ['data' => ['name' => 'evai', 'mobile' => 12345678910]];

View::display('index', $assigns);

安装说明 ¶

安装说明¶

FizeView 的环境要求如下：

“php”: “>=5.4.0” ，很多视图引擎要求 PHP7 ，所以还是推荐使用 PHP7 以上版本。
如果使用 Blade 引擎，请 composer 安装 illuminate/view 。
如果使用 Smarty 引擎，请 composer 安装 smarty/smarty 。
如果使用 Think 引擎，请 composer 安装 topthink/think-template 。
如果使用 Twig 引擎，请 composer 安装 twig/twig 。

使用Composer安装¶

FizeView 支持使用 Composer 安装，也是唯一官方推荐的安装方法。

注解

如果您尚未安装 composer ，请参考安装 composer 。

使用阿里云镜像以提高下载速度及稳定性。

在命令行下面，切换到您的项目根目录下面并执行下面的命令：

composer require fize/view

根据需要，选择 FizeView 处理器。使用 composer 下载依赖或者开启相应扩展。

好了！您现在可以开始使用 FizeView 了，就是这么简单！~

注解

Fize 项目(包括所有子项目)严格遵守语义化版本，您可以放心大胆的使用。

更新日志 ¶

更新日志¶

v1.2.2 (2019-12-10) : 修正没有模板赋值时触发的 null 错误。
v1.2.1 (2019-12-03) : 修正参数命名。
v1.2.0 (2019-12-02) : doc 注释优化，优化构造方法。
v1.1.0 (2019-11-18) : 添加视图初始化和静态方法调用。
v1.0.2 (2019-10-09) : Twig 强依赖模板文件夹，使用 FizeIo 依赖来进行模板文件夹创建。
v1.0.1 (2019-10-06) : git压缩包忽略.gitignore文件。
v1.0.0 (2019-09-19) : 支持主流模板引擎：PHP、Twig、Blade、Think、Smarty。

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

注解

以下为中文译文

MIT 开源许可协议¶

特此向任何得到本软件副本或相关文档的人授权：被授权人有权使用、复制、修改、合并、出版、发布、散布、再授权和/或贩售软件及软件的副本，及授予被供应人同等权利，只需服从以下义务：

该软件是”按原样”提供的，没有任何形式的明示或暗示，包括但不限于为特定目的和不侵权的适销性和适用性的保证担保。在任何情况下，作者或版权持有人，都无权要求任何索赔，或有关损害赔偿的其他责任。无论在本软件的使用上或其他买卖交易中，是否涉及合同，侵权或其他行为。

捐赠我们 ¶

捐赠我们¶

Fize 项目及其下所有子项目目前都为个人维护，坚持开源和免费提供使用。如果您对我们的成果表示认同并且觉得对你有所帮助我们愿意接受来自各方面的捐赠。

使用手机支付宝扫描进行捐赠

https://i.loli.net/2019/11/19/MY9pe7vIb1rUGf4.jpg

使用手机微信扫描进行捐赠

https://i.loli.net/2019/11/19/wGWiC6mEr1MTD9K.jpg

以下是捐赠明细(截止2019-11-19)：

梁*萍 50.00元

董*辉 100.00元

曾*庆 20.00元

许*钦 10.00元

陈* 88.88元

模板引擎配置 ¶

模板引擎配置¶

Blade¶

Blade 是 Laravel 提供的一个简单而又强大的模板引擎。

参数名	说明	是否可选	默认值
view	模板文件夹	是	‘./view’
cache	缓存文件夹	是	‘./runtime’

注解

使用 composer 安装 illuminate/view 以开启 Blade。

其他参数请参考 Laravel 中文文档

Php¶

PHP 原生模板引擎。

参数名	说明	是否可选	默认值
view	模板文件夹	是	‘./view’
suffix	视图文件后缀	是	‘php’

Smarty¶

Smarty 参数通过其属性来设置。

注解

使用 composer 安装 smarty/smarty 以开启 Smarty。

参数请参考 Smarty 中文文档

Think¶

ThinkTemplate 是一个基于 XML 的性能卓越的编译型模板引擎，支持两种类型的模板标签，使用了动态编译和缓存技术，而且支持自定义标签库，一直作为 ThinkPHP 的内置模板引擎，现已经支持独立使用。

注解

使用 composer 安装 topthink/think-template 以开启 Think。

参数请参考 ThinkTemplate开发指南

Twig¶

Twig是一个流行、严谨的模板引擎，多个 IDE 都对 Twig 进行高亮支持，对开发者非常友好。

参数名	说明	是否可选	默认值
view	模板文件夹	是	‘./view’
suffix	模板后缀名	是	‘twig’
cache	缓存文件夹	是	‘./runtime’

注解

使用 composer 安装 twig/twig 以开启 Twig。

其他参数请参考 Twig 手册

类库参考 ¶

类库参考¶

视图类¶

属性	值
命名空间	fize\view
类名	View

方法:

方法名	说明
__construct()	构造方法
engine()	获取底部引擎对象
path()	设置模板路径
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容
getInstance()	取得实例

方法¶

__construct()¶

构造方法

public function __construct (
    string $handler,
    array $config = []
)

参数:

名称	说明
handler	处理器
config	参数配置

在构造方法中设置默认引擎

engine()¶

获取底部引擎对象

public static function engine () : mixed

path()¶

设置模板路径

public static function path (
    string $path
)

参数:

名称	说明
path	模板路径

assign()¶

变量赋值

public static function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public static function render (
    string $path = null,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public static function display (
    string $path = null,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

getInstance()¶

取得实例

public static function getInstance (
    string $handler,
    array $config = []
) : \fize\view\ViewHandler

参数:

名称	说明
handler	处理器
config	参数配置

视图接口¶

属性	值
命名空间	fize\view
类名	ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底部引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

abstract public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底部引擎对象

abstract public function engine () : mixed

assign()¶

变量赋值

abstract public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

abstract public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

abstract public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

处理器¶

Blade¶

属性	值
命名空间	fize\view\handler
类名	Blade
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底部引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底部引擎对象

public function engine () : mixed

assign()¶

变量赋值

public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

Blitz¶

属性	值
命名空间	fize\view\handler
类名	Blitz

CodeIgniter¶

属性	值
命名空间	fize\view\handler
类名	CodeIgniter

Dwoo¶

属性	值
命名空间	fize\view\handler
类名	Dwoo

Fenom¶

属性	值
命名空间	fize\view\handler
类名	Fenom

Foil¶

属性	值
命名空间	fize\view\handler
类名	Foil

Latte¶

属性	值
命名空间	fize\view\handler
类名	Latte

Liquid¶

属性	值
命名空间	fize\view\handler
类名	Liquid

MtHaml¶

属性	值
命名空间	fize\view\handler
类名	MtHaml

Mustache¶

属性	值
命名空间	fize\view\handler
类名	Mustache

PHP¶

属性	值
命名空间	fize\view\handler
类名	Php
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底部引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底部引擎对象

public function engine () : mixed

assign()¶

变量赋值

public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

Phptal¶

属性	值
命名空间	fize\view\handler
类名	Phptal

Plates¶

属性	值
命名空间	fize\view\handler
类名	Plates

Pug¶

属性	值
命名空间	fize\view\handler
类名	Pug

RainTPL¶

属性	值
命名空间	fize\view\handler
类名	RainTPL

Smarty¶

属性	值
命名空间	fize\view\handler
类名	Smarty
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底部引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底部引擎对象

public function engine () : mixed

assign()¶

变量赋值

public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

Think¶

属性	值
命名空间	fize\view\handler
类名	Think
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底部引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底部引擎对象

public function engine () : mixed

assign()¶

变量赋值

public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

TinyButStrong¶

属性	值
命名空间	fize\view\handler
类名	TinyButStrong

Twig¶

属性	值
命名空间	fize\view\handler
类名	Twig
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()	初始化模板
engine()	获取底层引擎对象
assign()	变量赋值
render()	返回渲染内容
display()	显示渲染内容

方法¶

__construct()¶

初始化模板

public function __construct (
    array $config = []
)

参数:

名称	说明
config	配置

engine()¶

获取底层引擎对象

public function engine () : mixed

assign()¶

变量赋值

public function assign (
    string $name,
    mixed $value
)

参数:

名称	说明
name	变量名
value	变量

render()¶

返回渲染内容

public function render (
    string $path,
    array $assigns = []
) : string

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

display()¶

显示渲染内容

public function display (
    string $path,
    array $assigns = []
)

参数:

名称	说明
path	模板文件路径
assigns	指定变量赋值

Volt¶

属性	值
命名空间	fize\view\handler
类名	Volt

Zend¶

属性	值
命名空间	fize\view\handler
类名	Zend
实现接口	fize\view\ViewHandler

方法:

方法名	说明
__construct()
engine()
assign()
render()
display()

方法¶

__construct()¶

public function __construct (
    mixed $config = []
)

参数:

名称	说明
config

engine()¶

public function engine ()

assign()¶

public function assign (
    mixed $name,
    mixed $value
)

参数:

名称	说明
name
value

render()¶

public function render (
    mixed $path,
    mixed $assigns = []
)

参数:

名称	说明
path
assigns

display()¶

public function display (
    mixed $path,
    mixed $assigns = []
)

参数:

名称	说明
path
assigns

FizeView参考手册¶

欢迎使用¶

欢迎使用¶

处理器支持¶

入门三部曲¶

1.配置参数¶

2.设置默认模板引擎或者设置新模板引擎¶

3.进行模板编写即其他操作¶

入门示例¶

安装说明¶

安装说明¶

使用Composer安装¶

更新日志¶

更新日志¶

许可协议¶

许可协议¶

The MIT License (MIT)¶

MIT 开源许可协议¶

捐赠我们¶

捐赠我们¶

模板引擎配置¶

模板引擎配置¶

Blade¶

Php¶

Smarty¶

Think¶

Twig¶

类库参考¶

类库参考¶

视图类¶

方法¶

__construct()¶

engine()¶

path()¶

assign()¶

render()¶

display()¶

getInstance()¶

视图接口¶

方法¶

__construct()¶

engine()¶

assign()¶

render()¶

display()¶

处理器¶

Blade¶

方法¶

Blitz¶

CodeIgniter¶

Dwoo¶

Fenom¶

Foil¶

Latte¶

Liquid¶

MtHaml¶

Mustache¶

PHP¶

方法¶

Phptal¶

Plates¶

Pug¶

RainTPL¶

Smarty¶

方法¶

Think¶

方法¶

TinyButStrong¶

Twig¶

方法¶

Volt¶

Zend¶

方法¶

欢迎使用 ¶

安装说明 ¶

更新日志 ¶

许可协议 ¶

捐赠我们 ¶

模板引擎配置 ¶

类库参考 ¶