SpringView for Yaf

介绍

在我们以往的大量 PHP 项目中都使用了鸟哥贡献的 Yaf 开发框架，Yaf 框架运行效率高（C扩展），结构简单易上手，随PHP更新迭代快，实为“国货之光”。

在 Yaf 的使用过程中，对于视图模板的功能，框架本身自带的 Yaf_View_Simple 对于稍复杂项目开发来说功能过于基础和简陋。后来我们使用另一个开源的 C扩展模板引擎 blitz 继承实现了 Yaf 的视图，基本能满足开发需求。不过随着项目的复杂性增加，以及某些项目准备开源的想法，blitz模板自身迭代慢、有学习门槛、功能不易扩展逐渐成为了一种限制。有鉴于此，我们基于团队以往开发中积累的经验教训，结合最常用的使用需求，开发了 SpringView 视图模板引擎。

在 SpringView v1.2 的基础上，我们实现了对 Yaf 专门适配的版本：

对 Yaf_View_Interface 抽象方法的具体实现
基于 SpringView 简单易用的模板符号语法
采用文件缓存的方式，提升脚本执行效率
支持布局视图方式

欢迎访问 SpringView in Gitee 或 SpringView in SpringPHP 了解 SpringView 视图模板引擎的功能及示例演示。

类库方法说明

public 方法
- __construct($viewPath, $cachePath) 类库初始化
- assign($spec, $value) 设置视图模板中的变量值
- render($viewFile, $viewVars) 返回指定视图模板的输出内容
- display($viewFile, $viewVars) 直接显示指定视图模板的输出内容
- setJson($json) 设置是否将数据输出为json格式（不使用模板渲染）
- setLayout($layoutFile, $blockFlagForView) 使用指定的布局视图模板
- setBlock($blockFlag, $viewFile) 设置布局视图模板中内容块的对应视图文件
- setScriptPath($viewDirectory) 设置视图模板文件所在目录
- getScriptPath() 返回视图模板文件所在目录
- setCachePath($cacheDirectory) 设置视图模板缓存文件所在目录
- getCachePath() 返回视图模板缓存文件所在目录
- setCacheLifetime($cacheSeconds) 设置缓存文件的有效时间（秒）
- getCacheLifetime() 返回缓存文件的有效时间设定值
- cleanCache($viewFile) 删除指定视图模板的缓存文件
private 方法
- getCacheFile($viewPathFile) 返回指定视图路径文件的缓存文件（若缓存失效则重新生成）
- buildCacheFile($viewPathFile, $cachePathFile) 将指定视图模板转换为PHP代码缓存文件并保存
- parseView($code) 分析处理指定模板代码，返回转换后的PHP代码
- parseFileTags($code) 分析处理模板代码中的文件引用标签，返回经过转换的代码
- parseLoopTags($code) 分析处理模板代码中的循环结构（含子循环）标签，返回经过转换的代码
- parseIfTags($code) 分析处理模板代码中的条件判断结构标签，返回经过转换的代码
- parseVariableTags($code) 分析处理模板代码中的变量（含表达式）输出标签，返回经过转换的代码
- parseHtmlTags($code) 分析处理模板代码中的特定html模板标签，返回经过转换的代码
- parseBlockTags($code) 分析处理模板代码中的内容区块标签，返回经过转换的代码
- isValidChar($x) 判断指定字符是否PHP变量名允许使用的字符

Yaf 使用说明

请复制 SpringView.php 类文件到项目 Yaf 框架 application.library 或 yaf.library 对应的类库目录下，默认设置一般都在 "application/library/" 下。
在 Yaf 框架的插件目录（一般为"application/plugins/"）下，创建一个初始化视图模板引擎的插件文件（比如叫 View.php），参考代码如下：

<?php
class ViewPlugin extends Yaf_Plugin_Abstract
{
    /**
     * 操作正式处理之前执行，初始化视图模板引擎
     * @return void
     */
    public function dispatchLoopStartup(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response)
    {
         $viewPath = APPLICATION_PATH . '/views/'; //这里改为你的视图模板文件所在目录
         $viewCachePath = APPLICATION_PATH . '/cache/'; //这里改为你的视图模板缓存文件保存目录
         //为 Yaf 框架指定 SpringView 为视图处理引擎
         Yaf_Dispatcher::getInstance()->setView(new SpringView($viewPath, $viewCachePath)));
    }
}

配置完以上内容，就可以在 Yaf 框架控制器 Controller 下的方法（ Action ）中使用 SpringView 处理视图模板输出了，以下是代码举例：

<?php
class IndexController extends Yaf_Controller_Abstract
{
    /**
     * 默认首页
     */
    public function IndexAction()
    {
        //处理请求参数
        $request = $this->getRequest();
        $search  = array(
            'name'   => $request->getPost('name', ''),
            'status' => $request->getPost('status', STATUS_ALL),
        );
        //组装查询参数
        $params = $search + array(
            'search' => $search,
            'page' => 1,
            'rows' => 20,
        );
        //调用数据 model 查询数据
        $C = M::load('Customer');
        $result = $C->search($params);
        $params['total'] = $result['count'];
        $params['list']  = $result['data'];

        //最后将数据转给视图，输出内容
        $this->getView()->assign($params);

        //如果想将结果输出为Json，则
        $this->getView()->setJson(true);
    }
}

参与贡献

Fork 本仓库
新建 Feat_xxx 分支
提交代码
新建 Pull Request

感谢

感谢每个来到这里的 “拍黄片”男一号
感恩送出 Star 的你
祝福 PHP 不死

SpringPHP / SpringView for Yaf

SpringView for Yaf

介绍

类库方法说明

Yaf 使用说明

参与贡献

感谢

简介

发行版

贡献者

近期动态

SpringPHP / SpringView for Yaf .gitee-modal { width: 500px !important; }

SpringView for Yaf

介绍

类库方法说明

Yaf 使用说明

参与贡献

感谢

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

SpringPHP / SpringView for Yaf