dedecms模板引擎介绍

  • 作者: admin
  • 发布日期: 2013-08-16 02:03:02
  • 点击:

DedeCMS从V5开始采用了解析式引擎与编译式引擎并存的模式,由于在生成HTML时,解析式引擎拥有巨大的优势,但对于动态浏览的互动性质的页面,编译式引擎更实用高效,织梦CMS采用双引擎并存的模式,在保持标签风格一致性的同时,也保证将来开发更多互动模块时有更好的性能。

静态模板引擎

核心文件

include/dedetag.class.php

功能描述

DedeCMS V5.3及之前版本使用的主要的模板类,它是解析式模板类,并非编译式的。

注:编译式是通过获得标签位置进行内容替换,编译式是直接解析为PHP代码,二次执行。

模板语法

织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。

织梦模板引擎的代码样式

{dede:标记名称 属性='值'/}
{dede:标记名称 属性='值'}{/dede:标记名称}
{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称}

注:如果使用带底层模板的标记,必须严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式,否则会报错。

内置系统标记

① global标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:
{dede:global name='变量名称'}{/dede:global}

{dede:global name='变量名称'/}

其中变量名称不能加$符号,如变量$cfg_cmspath,应该写成{dede:global name='cfg_cmspath'/}。

②foreach用来输出一个数组,形式为:
 {dede:foreach array='数组名称'}[field:key/] [field:value/]{/dede:foreach}

③include引入一个文件,形式为:
 {dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/}
 对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录

自定义函数使用

{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")'/}

其中@me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:

{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

织梦标记允许有限的编程扩展

格式为:
{dede:tagname runphp='yes'}
       $aaa = @me;
       @me = "123456";
{/dede:tagname}
@me 表示这个标记本身的值,因此标记内编程是不能使用echo之类的语句的,只能把所有返回值传递给@me。
此外由于程序代码占用了底层模板InnerText的内容,因此需编程的标记只能使用默认的InnerText。


动态模板引擎

核心文件

include/dedetemplate.class.php

功能描述

用于非核心模块的动态页面或列表页的模板解析,如:member/content_list.php ,通常是在datalistcp.class.php 中使用,这个类在动态运行的情况下,由于本身是把模板编译成PHP的,因此性能上会优级于旧的解析类,这个方法将在未来版本中作为通用的方式。

使用方法
 

$tpl = new DedeTemplate(
模板对象实例名称,通常是'tpl',
[模板存放目录(生成缓存时会存放在这个目录),

include语法默认引用目录]

);
通常情况下参数二和参数三是不必要的,如:
$tpl = new DedeTemplate('tpl');
如果在类文件中调用,应该加上设置:
$this->tpl->SetObject($this);
在一些块调用中默认将使用当前类的成员函数。
$tpl->LoadTemplate(模板的物理路径);
如果模板中带有{dede:config name='' value=''/}
可以在载入模板后,通过$tpl->GetConfig($name) 获得这些变量的值。

显示页面或保存页面为文件
$tpl->Display();
$tpl->SaveTo(物理绝对路径的文件名);


标记语法


标记通用特性

① 短标记
{dede:tagname.name/}
等同于
{dede:tagname name='' /}
② 块标记
{dede:tagname}
循环代码
{/dede:tagname}

标记的具体语法及对应的PHP代码

① 配置变量
{dede:config name='' value=''/}
配置变量可以在载入模板后通过$tpl->GetConfig($name) 获得,仅作为配置,不在模板中显示。
② 短标记

{dede:global.name/}   外部变量      等同于<?php echo $name; ?>
{dede:var.name/}      var数组       等同于<?php echo $_vars['name']; ?>
{dede:field.name/}    field数组     等同于<?php echo $fields['name']; ?>
{dede:cfg.name/}      系统配置变量  等同于<?php echo $cfg_name; ?>
考虑到大多数情况下都会在函数或类中调用模板,因此$_vars、$fields 数组必须声明为global 数组,否则模板引擎无法获得它的值从而导致产生错误。

③ 自由调用块标记

{tag:blockname bind='GetArcList' bindtype='class'}
循环代码
{/tag:blockname}
必要属性:
bind       数据源来源函数
bindtype   函数类型,默认是class 可选为sub
rstype     返回结果类型,默认是array ,可选项为string
自定义函数格式必须为function(array $atts,object $refObj, array $fields);
在没有指定bind 绑定的函数的情况下,默认指向MakePublicTag($atts,$tpl->refObj,$fields) 统一管理。

④ 固定块标记

1.datalist
从绑定类成员函数GetArcList中获取数组并输出
{dede:datalist}
循环代码
{/dede:datalist}
遍历一个二给维数组,数据源是固定的,只适用用类调用。
等同于
{tag:blockname bind='GetArcList' bindtype='class' rstype='arrayu'}
循环代码
{/tag:blockname}

2.label

从绑定函数中获取字符串值并输出
等同于{tag:blockname bind='func' bindtype='sub' rstype='string'/}

3.pagelist

从绑定类成员函数GetPageList中获取字符串值并输出
等同于{tag:blockname bind='GetPageList' bindtype='class' rstype='string'/}

4.include
{dede:include file=''/}
{dede:include filename=''/}

5.php

{dede:php
php 代码
/}

{dede:php}
php代码
{/dede:php}

6.If

仅支持if ,else ,else 直接用{else}表示,但不支持{else if}这样的语法,一般建议模板中不要使用太复杂的条件语法,如果确实有需要,可以直接使用php 语法。
{dede:if 条件} a-block  {else} b-block {/dede:if}
条件中允许使用var.name 、global.name 、field.name、cfg.name 表示相应的变量。
如:
{dede:if field.id>10 }
{/dede:if}

7.遍历一个array 数组

{dede:array.name}
  {dede:key/} = {dede:value/}
{/dede:array}
各种语法的具体编译后的代码,可查看dedetemplate.class.php的function CompilerOneTag(&$cTag)。

 

网站备案所需要提供的资料清单

目前,国内每个网站都必须具有信息产业部批准的备案号才能正常开通,否则只有选择国外的服务器。