PHPackages hehex/hehep-htemplate - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. hehex/hehep-htemplate ActiveLibrary[Templating & Views](/categories/templating) hehex/hehep-htemplate ===================== hehep-htemplate 是一个PHP模板引擎基础组件 v1.0.0(1y ago)014Apache-2.0PHPPHP >=7.1 Since Aug 31Pushed 10mo ago1 watchersCompare [ Source](https://github.com/chinahehex/hehep-htemplate)[ Packagist](https://packagist.org/packages/hehex/hehep-htemplate)[ RSS](/packages/hehex-hehep-htemplate/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) hehep-htemplate =============== [](#hehep-htemplate) 介绍 -- [](#介绍) - hehep-htemplate 是一个PHP 模板引擎组件 - 支持{{}},{},以及<> 标签混合使用 - 支持layout(模板继承) 标签 - 支持block 模块 - 支持include 标签 - 支持if 标签 - 支持for dict,list 标签 - 支持注释 - 支持php代码标签 - 支持调用方法 - 支持加载静态文件 - 定义变量 - 支持不解析标签 - html 标签 - 自定义过滤器 - 优化方法的调用方式,支持| 方法,支持定义参数 - 支持标签,empty - 支持导入自定义过滤器 - 支持导入自定义标签 - 支持模板文件缓存代码至内存 - 支持代码缓存过期时间 - 支持模板后缀自定义 - js,css,img 标签 - 提供小物件(widget) 安装 -- [](#安装) - **gitee下载**: ``` git clone git@gitee.com:chinahehex/hehep-htemplate.git ``` - **github下载**: ``` git clone git@github.com:chinahehex/hehep-htemplate.git ``` - 命令安装： ``` composer require hehep/htemplate ``` 组件配置 ---- [](#组件配置) - 基础配置 ``` $conf = [ // 上下文对象 'context'=>[],//phpweb 'filters'=>[ 'h'=>'hehe' ], // 模板文件根路径 'tplPath'=>'@app@/view/', // 系统标签,默认自动加载sys 表达式,默认标签,书写时无需写入前缀,比如 'sysTags'=>['sys'], // 自定义标签,书写时必须写入前缀,比如 标签名称html,则css 标签的书写规则为: 'customTags'=>['html'], // 模板文件扩展名 'suffix' => 'html', // 缓存文件扩展名 'cacheSuffix' => 'php', // 是否开启模板缓存,开启后,会自动缓存代码,加快模板解析的速度 'onCache' => true, // 模板缓存文件目录,模板编译的python代码缓存在文件中,缓存文件存储此目录中 'cachePath' => '/home/hehe/www/cache/htpl/', // 资源地址,比如js,css,img,默认提供static(静态资源路径),res(外部资源,比如上传的文件) 字典key 'urls'=>[ 'static'=>'http://eduhome.xuewei.cn/' ], // 模板缓存有效期,单位秒,0 表示无有效期 'timeout' => 5, // 表达式起始符 'expStart' => '{{', // 表达式结束符 'expEnd' => '}}', // 结束表达式的结束符比如/ 则完整表达式为{/for} 或end,{endfor} 'expEndEof' => '/', // 是否启用标签规则,开启后,匹配表达式 'onTag' => true, // 标签起始符 'tagStart' => '', // 结束标签结束符号 'tagEndEof' => '/', ]; ``` 基本用法 ---- [](#基本用法) - php 示例代码 ``` use htemplate\TemplateManager; $config = []; $htemplate = new TemplateManager($config); // 加载(user/add)模板,返回模板内容 $data = [ 'msg'=>'hello world' ]; $html = $htemplate->fetch("user/index",$data); ``` - 模板html示例代码 ``` > Title {{msg}} ``` 过滤器 --- [](#过滤器) ``` 在模板页面里使用的函数或方法称为过滤器,可自定义过滤器,比如系统默认过滤器hehe ``` ### 定义过滤器 [](#定义过滤器) - 定义过滤器类 ``` namespace admin\htemplate\filters; class HeheFilter { public static function date_filter($format,$datetime) { return date($format,strtotime($datetime)); } } ``` ### 加载过滤器 [](#加载过滤器) ``` $config = [ 'filters'=>[ // ‘过滤器方法前缀’=>'过滤器类路径' 'he_'=>'\admin\htemplate\filters\HeheFilter' ]; // 方式一 $htemplate = new htemplate\TemplateManager($config); // 方式二 $htemplate = new htemplate\TemplateManager(); $htemplate->addFilters(['he_'=>'\admin\htemplate\filters\HeheFilter']); ``` ### 模板页面使用过滤器 [](#模板页面使用过滤器) ``` {{:he_date('Y-m-d','2010-02-05 05:20')}} ``` 上下文 --- [](#上下文) ``` 在模板页面里默认可以使用的数据,比如$_REQUEST,$_SESSION,$_COOKIES,等等, 模板加载时,会自动注入对应的上下文数据至模板页面 目前只支持phpweb(传统的web php),后续可扩展swoole 上下文,或workerman上下文 ``` ### 定义上下文类 [](#定义上下文类) ``` namespace admin\htemplate\contexts; class PhpwebContext { public function handle() { return [ '_request'=>&$_REQUEST, '_get'=>&$_GET, '_post'=>&$_POST, '_server'=>&$_SERVER, '_cookie'=>&$_COOKIE, '_session'=>&$_SESSION, '_files'=>&$_FILES, ]; } } ``` ### 配置上下文 [](#配置上下文) ``` $config = [ // 上下文 'context'=>['admin\htemplate\contexts\PhpwebContext'], ]; // 方式1 $htemplate = new htemplate\TemplateManager($config); // 方式2 $htemplate->addContext('admin\htemplate\contexts\PhpwebContext'); ``` ### 模板页面使用上下文 [](#模板页面使用上下文) ``` {{$_get['id']}} ``` 标签 -- [](#标签) ``` 模板引擎里提供的所有功能都是通过标签形式提供,可通过自定义新的标签实现多更功能扩展 标签属性: name:标签名称 close:是否闭合标签 onTag:是否支持html标签格式 handler:标签处理方法或函数 ``` ### 自定义标签 [](#自定义标签) ``` namespace admin\htemplate\tags; use htemplate\base\BaseTag; use htemplate\base\TagExpression; use htemplate\nodes\BaseNode; class HtmlTag extends BaseTag { // 定义标签 protected $tags = [ // 表单select ['name'=>"select", 'close'=>false,'onTag'=>true], // 不解析内容标签 ['name'=>"pass", 'close'=>true,'onTag'=>true],# 标签库 ]; // 非闭合标签 public function select_tag(TagExpression $tagExp,$node_attrs,BaseNode $mainNode) { $attrs = $this->buildTagAttrs($node_attrs); list($html_attrs,$he_attrs) = $this->spiltAttrs($attrs); $he_name = $he_attrs['he-name']; $he_text = isset($he_attrs['he-text']) ? $he_attrs['he-text'] : ''; $he_selected = isset($he_attrs['he-selected']) ? $he_attrs['he-selected'] : ''; if (empty($he_selected)) { $he_ctx = '$_request'; if (!empty($he_attrs['he-ctx'])) { $he_ctx = $he_ctx['he-ctx']; } $var_name = $he_ctx . '.' . $html_attrs['name']; $he_selected = $this->buildVarName($var_name); } $html_attrs = $this->attrHtml($html_attrs); $html = ' {text} {option_name} {option_name} '; $html = $this->formatHtml($html,[ 'attrs'=>$html_attrs, 'text'=>$he_text, 'options'=>$he_name, 'selected'=>$he_selected, 'option_key'=>'', 'option_name'=>'' ]); $mainNode->writeCode($html); } public function pass_tag(TagExpression $tagExp,$node_attrs,BaseNode $mainNode,BaseNode $subNode) { $mainNode->writeCode($subNode->getBody()); } } ``` ### 加载标签类 [](#加载标签类) ``` $config = [ // 上下文 'customTags'=>['html'=>'\admin\htemplate\tags\HtmlTag'], ]; // 方式1 $htemplate = new htemplate\TemplateManager($config); // 方式2 $htemplate->addCustomTags(['html'=>'\admin\htemplate\tags\HtmlTag']); // 标签作为系统标签 $htemplate->addSysTags(['\admin\htemplate\tags\HtmlTag']); ``` ### 自定义标签模板中使用 [](#自定义标签模板中使用) ``` {{html:pass}} {{include file="common/footer"}} {{html:js src="js/dist/seajs.min.js" }} {{/html:pass}} ``` 系统默认标签 ------ [](#系统默认标签) ### layout 布局标签 [](#layout-布局标签) ``` 标签属性: file:布局文件路径 name:替换的关键词,默认content ``` - 布局文件 layout\\home.html ``` > __CONTENT__ ``` - 加载布局文件 ``` {{layout file="layout/home"}} welcome you ``` ### include 标签 [](#include-标签) ``` 标签属性: file:模板路径 ``` - 示例 ``` {{include file="common/footer"}} ``` ### taglib 标签 [](#taglib-标签) ``` 模板页面里动态加载模板标签,标签需在页面第一行加载 标签属性: name：标签类路径 alias:标签别名,比如html ``` - 示例 ``` {{taglib name="html"}} ``` ### block 区块标签 [](#block-区块标签) ``` 标签属性: name:区块名称,对应布局文件的内容替换标识,比如__TITLE__,__CONTENT__ ``` - 示例 ``` {{block name="title"}} name:{{$name}} {{/block}} ``` ### widget 小物件标签 [](#widget-小物件标签) ``` 通用功能模块的封装,一般会输出页面 标签属性: name:小物件类路径,比如admin.service.Address@@ok args:小物件参数 constructor:参数是否传入构造器,否则直接传入小物件对应的方法 小物件类路径格式:.,@,@@ - \表示默认调用Address 的handle 方法 admin.service.Address - @ 表示创建Address 对象并调用close 方法 admin.service.Address@close - @@ 表示调用Address 类的静态close 方法 admin.service.Address@@close ``` - 示例 ``` ``` ### if 标签 [](#if-标签) ``` 标签属性: cond 或 condition: 条件语句 ``` - 示例 ``` {{$age}} {{$age}} {{$age}} ``` ### foreach遍历标签 [](#foreach遍历标签) ``` 标签属性: name:遍历的数组 value:数组元素 key:数组键值 index:序号,从0开始累加 ``` - 示例 ``` {{foreach name="arr" value="vo" key="k" index="i"}} 姓名:{{$vo['realName']}} 数组键:{{$k}} 序号:{{$i}} {{/foreach}} ``` ### for 遍历标签 [](#for-遍历标签) ``` 标签属性: name:当前数值变量 start:起始值,大于等于起始值 end:结束值,小于等于结束值 step:步长,每次累加的值 ``` ``` {{for name="index" start="1" end="8" step="2"}} 输出:{{$index}}; {{/for}} ``` ### js,css 静态资源标签 [](#jscss-静态资源标签) - 示例 ``` ``` ### switch 标签 [](#switch-标签) - 示例 ``` {{switch name="age"}} {{case value="1"}} 1 {{/case}} {{case value="2"}} 2 {{/case}} {{default}} 333 {{/switch}} ``` ### PHP原生标签 [](#php原生标签) - 示例 ``` {{php}} $name=2;{{/php}} ``` ### 条件标签 [](#条件标签) - 示例 ``` title 为空 title 不为空 数组$stu['name'] 是否存在 ``` ### 比较标签 [](#比较标签) ``` 比较标签有以下 eq:等于 neq:不等于 heq:恒等于 nheq:非恒等于 gt:大于 egt:大于等于 lt:小于 elt:小于等于 ``` - 示例 ``` {{eq name="status" value="1"}} 变量$status 等于1 {{/eq}} {{gt name="status" value="1"}} 变量$status 大于1 {{/gt}} ``` ### 范围标签 [](#范围标签) ``` {{in name="invalue" value="1"}} 1 存在$invalue 数组中 {{/in}} {{noin name="invalue" value="1"}} 1 不存在$invalue 数组中 {{/noin}} {{between name="[1,10]" value="1"}} 值在1-10 范围内 {{/between}} ``` ### pass原样输出标签 [](#pass原样输出标签) - 示例 ``` {{pass}} {{include file="common/footer"}} {{html:js src="js/dist/seajs.min.js" }} {{/pass}} ``` ### 字典标签 [](#字典标签) ``` 标签属性: name:字典集合 keys:目标字典值,多个键值逗号隔开 defualt:默认值 ``` - 示例 ``` ``` html 标签 ------- [](#html-标签) ``` 为了区分html 标签属性与自定义标签的属性,则自定义标签的属性名称统一以he- 作为前缀,比如he-name,he-value ``` ### 表单标签 [](#表单标签) - 示例 ``` ``` ### 静态资源地址标签 [](#静态资源地址标签) - 示例 ``` ``` 系统默认过滤器 ------- [](#系统默认过滤器) ### xss 危险标签过滤 [](#xss-危险标签过滤) ``` {{:he_xss($name)}} ``` ### 过滤所有危险字符 [](#过滤所有危险字符) ``` {{:he_safe($name)}} ``` ### 加载小物件 [](#加载小物件) ``` {{:he_widget('admin.service.Address@@ok',['page'=>$page])}} ``` ### 日期格式化 [](#日期格式化) ``` {{:he_date('Y-m-d',$ctime)}} ``` ### 截取字符串 [](#截取字符串) ``` {{:he_substr($name,0,10)}} {{:he_substr($name,0,10,'...')}} ``` ### 显示指定字典文本 [](#显示指定字典文本) ``` {{:he_dict($dicts,$dict_key)}} {{:he_dict($dicts,$dict_key)}} ``` ### 显示多个字典文本 [](#显示多个字典文本) ``` {{:he_dict($dicts,$dict_keys)}} {{:he_dict($dicts,$dict_keys,'多个字典文本分隔符','默认值')}} ``` 任务列表 ---- [](#任务列表) - 支持html属性变量 ok - 支持标签属性变量ok - 支持两种解析方式,加快编译速度 - 支持过滤器 ok - 标签支持别名定义 ok - 支持小物件 ok - 定义常用过滤器(日期格式,截取字符串,数字格式,字典)ok - 支持其他框架上下文 - 支持html 标签ok ### Health Score 24 — LowBetter than 32% of packages Maintenance45 Moderate activity, may be stable Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 619d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/fef1cea3ff1614a44fc4060212c8e03e14511610ae5482351a80a3b9f6d28e97?d=identicon)[chinahehex](/maintainers/chinahehex) --- Top Contributors [![139hehe](https://avatars.githubusercontent.com/u/42648391?v=4)](https://github.com/139hehe "139hehe (14 commits)") --- Tags phpsmartytemplate ### Embed Badge ![Health badge](/badges/hehex-hehep-htemplate/health.svg) ``` [![Health](https://phpackages.com/badges/hehex-hehep-htemplate/health.svg)](https://phpackages.com/packages/hehex-hehep-htemplate) ``` ### Alternatives [mustache/mustache A Mustache implementation in PHP. 3.3k44.6M291](/packages/mustache-mustache)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[whitecube/nova-flexible-content Flexible Content & Repeater Fields for Laravel Nova. 8053.0M25](/packages/whitecube-nova-flexible-content)[mopa/bootstrap-bundle Easy integration of twitters bootstrap into symfony2 7042.9M33](/packages/mopa-bootstrap-bundle)[limenius/react-bundle Client and Server-side react rendering in a Symfony Bundle 3871.2M](/packages/limenius-react-bundle)[nicmart/string-template StringTemplate is a very simple string template engine for php. I've written it to have a thing like sprintf, but with named and nested substutions. 2101.7M30](/packages/nicmart-string-template) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)