模板引擎smarty工作原理以及使用示例

smarty是一个使用PHP写出来的模板PHP模板引擎,它提供了逻辑与外在内容的分离,简单的讲,目的就是要使用PHP程序员同美工分 离,使用的程序员改变程序的逻辑内容不会影响到美工的页面设计,美工重新修改页面不会影响到程序的程序逻辑,这在多人合作的项目中显的尤为重要。

模板引擎是用于把模板文件和数据内容合并在一起的程序,便于网站开发有利于代码分离和维护,了解一个模板最好知道其工作原理,以便于实现一通万通。

模板文件一般是HTML xml js等类型文件,如果不用模板引擎若要把数据显示在网页上,我们需要在php中输出HTML,而使用模板则只要把数据交给模板引擎程序即可,然后告诉它用哪个模板文件,自然就会把数据和页面结合以后返回或输出,模板至少有以下功能1.把数据提供给模板引擎的功能。2.指定模板的功能。3.输出结果的功能。一般来说为了方便程序员们使用模板引擎,开发者都会把它的功能在一定程度上封装起来,封装成一个类,实例化之后得到一个对象,即模板引擎对象,一个对象有其属性和方法,smarty对象的属性和方法在smarty手册上查找,首先说说其方法,assign 把数据提交给模板的方法。没有单独的指定模板文件的方法已经合并到输出的方法中,输出的方法有两个 display 直接输出 fetch 返回合并好的HTML代码,对于输出我们主要用到的是assign 因为我们显示的数据往往是多样性的,可能是一个量,可能是一个数组量也可能是多维数组,在不同的情况下应该如何正确提交给smarty是一个问题,提交后如何对应显示也是个问题,smarty引擎使用的解释方法是先把HTML文件转化为php文件,然后在赋值各个量,并且执行这个php文件,对应不同的数据格式,它有一套固定的书写方式,需要我们用这种书写方式在模板文件上做对应的标记,smarty默认使用的模板标记符是一对{},比如{$a}这个标记等效于echo $a;在php中我们需要有对应的赋值过程,$smarty->assign("a","值");如果我们有多个量进行赋值,一个个这样写就很麻烦,smarty为我们考虑了这一点,例如我们从数据库里读出一个文章,要显示在页面的内容有标题内容作者时间,数据结构大体是这样的,代码如下:

array([id]=>1,['title']=>"标题",…);

我们的模板需要有几个对应的标记,例如:

<h1>{$title}</h1>

<div>{$content}</div>

一个个赋值太麻烦,assign方法支持数组直接赋值,$rows = 从数据库读出的据,$smarty->assign($rows);smarty就会取数据索引自动一一赋值,但是这个时候为了避免引起变量冲突,我们希望还是直接以数组形式赋值呢,例如如下代码:

$rows = 从数据库读出的据,

$smarty->assign("rows",$rows);

如果此时我们在模板的标记是{$rows} 那输出的时候我们只能看到array 正如php里面直接echo数组一样,在php输出具体量是echo $rows['title'];smarty规定的符号是一个点号,{$rows.title},用这种方式类似于如下:

echo $rows['title']

每种模板有其对应的书写规则,接下来如果要显示的是一个文章列表呢,假设mysql给我们返回了10条数据,10条数据都要显示出来,而且他们的索引肯定完全相同,根据编程思路知道结果求过程,假设显示如下:

  1. <ul>
  2. <li>1111</li>
  3. <li>222</li>
  4. <li>333</li>
  5. <li>4444</li>
  6. </ul>

如果这是我们希望输出的样子,首先这是多个量当然用的是数组了,代码如下:

  1. $list=array();
  2. While($rows=数据){
  3. $list[]=$rows;
  4. }
  5. $smarty->assign("list",$list);

先把数据放到一个数组中再一次性交给smarty,这样一来list变量里面是一个二维数组,如果是我们得到一个这样的二维数组,要把里面所有值显示出来,最好的方法是循环输出,同样smarty为我们提供了循环用的标记,section和 foreach

section标记格式,代码如下:

  1. {section name=这次循环的名字 loop=数据量名}
  2. ...
  3. {/section}
  4. {section name=i loop=$list}
  5. <li>{$list[i].title}</li>
  6. {/section}

上面的代码看起来很像for循环,但这里的i不是for循环里面的$i 只是这个循环的名字,$list[循环名]这个写法可以每次从数组里得到一个量,正如刚才说的,$list是一个二维数组,$list[i]得到的还是数组。

还有一个写法就是foreach 其语法如下:

  1. {foreach key=索引 item=值 from=赋值变量}
  2. {$key}:{$item}<br />
  3. {/foreach}
  4. {foreach item=v from=$list}
  5. <li>{$v.title}</li>
  6. {/foreach}

循环list变量每个量赋值到v里,然后从变量v里面指定要显示的索引,除了循环标记外,它还给我们提供了一些常用的语法标记,例如包含文件,条件判断,我们知道HTML不能包含文件,比如网页头部,但smarty提供了{include}的标记,可以像php一样包含文件,例如{include file="文件路径"} 这个标记格式是固定的,而且这个路径必须在模板引擎指定的路径下,而条件判断的语法和php一样是if条件判断,语法如下:

  1. {if变量==值或量}
  2. 为真时显示的值
  3. {else}
  4. 为假是显示的值
  5. {/if}

也可以不写else只有为真时显示的内容,例如常见的一种情况是网页上有一个登陆口登录前显示的是表单登录后显示的是用户信息,假设一个量已经赋值给模板了比如 $username 用户登录这个量就有用户名没有登录这个量就是空的,我们可以这样写:

  1. {if $username !=""}
  2. 欢迎{$username}
  3. {else}
  4. 请先登录
  5. {/if}

我们只要在php把这个变量准备好,并赋值给smarty即可除了这些标记外还有的标记自行参考手册,其次就是变量调节器了,很多时候我们从数据库中得到的数据,都要小小的处理下才输出的,比如日期格式,只显示年月日即可再如输出的内容里的换行要换成<br />才能在页面显示对应的样子,这个时候我们可以使用smarty自带的变量调节器,格式如下:

{要输出的变量|调节器名:参数}

假如内容部分在显示的时候把所有的换行显示为<br />只需要如下写法:

{$content|nl2br}

日期的格式化可以用date_format 例如手册上:

index.php:

  1. $smarty = new Smarty;
  2. $smarty->assign('yesterday', strtotime('-1 day'));
  3. $smarty->display('index.tpl');

index.tpl:

  1. {$smarty.now|date_format}
  2. {$smarty.now|date_format:"%A, %B %e, %Y"}
  3. {$smarty.now|date_format:"%H:%M:%S"}
  4. {$yesterday|date_format}
  5. {$yesterday|date_format:"%A, %B %e, %Y"}
  6. {$yesterday|date_format:"%H:%M:%S"}

OUTPUT:

  1. Feb 6, 2001
  2. Tuesday, February 6, 2001
  3. 14:33:00
  4. Feb 5, 2001
  5. Monday, February 5, 2001
  6. 14:33:00

实在不行我们可以用php处理好之后再进行赋值。

下面写上配置:

  1. <?php
  2. define("ROOT",str_replace('\\','/',dirname(__FILE__)).'/');//定义根路径
  3. //加载smarty类
  4. require ROOT.'lib/smarty.class.php';
  5. $samrty = new smarty();//实例化一个smarty类
  6. //配置各种目录
  7. $smarty ->setTemplateDir(ROOT.'templates/')
  8. ->setCompileDir(ROOT.'templates_c')
  9. ->setPluginsDir(ROOT.'plugins/')
  10. ->setCacheDir(ROOT.'cache/')
  11. ->setConfigDir(ROOT.'configs/');
  12. $smarty->caching = false;//是否开启缓存
  13. $smarty->left_delimiter = '<{';//设置左右 防止和js css 等发生冲突
  14. $smarty->right_delimiter = '}>';
  15. ?>