smarty
Smarty是一个php模板引擎。更准确的说,它分开了逻辑程序和外在的内容,提供了一种易于
管理的方法。可以描述为应用程序员和美工扮演了不同的角色,因为在大多数情况下,他们不
可能是同一个人。例如,你正在创建一个用于浏览新闻的网页,新闻标题,标签栏,作者和内容等
都是内容要素,他们并不包含应该怎样去呈现。在Smarty的程序里,这些被忽略了。模板设计
者们编辑模板,组合使用html标签和模板标签去格式化这些要素的输出(html表格,背景色,字
体大小,样式表,等等)。有一天程序员想要改变文章检索的方式(也就是程序逻辑的改变)。这
个改变不影响模板设计者,内容仍将准确的输出到模板。同样的,哪天美工吃多了想要完全重
做界面,也不会影响到程序逻辑。因此,程序员可以改变逻辑而不需要重新构建模板,模板设计
者可以改变模板而不影响到逻辑。
smarty 不尝试将逻辑完全和模板分开。如果逻辑程序严格的用于页面表现,那么它在模板里
不会出现问题。有个建议:让应用程序逻辑远离模板, 页面表现逻辑远离应用程序逻辑。这将
在以后使内容更容易管理,程序更容易升级
Smarty的特点之一是"模板编译"。意思是Smarty读取模板文件然后用他们创建php脚本。
这些脚本创建以后将被执行。因此并没有花费模板文件的语法解析,同时每个模板可以享受
到诸如Zend 加速 器(http://www.zend.com) 或者PHP 加速 器
(http://www.php-accelerator.co.uk)。这样的php编译器高速缓存解决方案。
Smaty的一些特点：
• It is extremely fast.
非常非常的快!
• It is efficient since the PHP parser does the dirty work.
用 php 分析器干这个苦差事是有效的
• No template parsing overhead, only compiles once.
不需要多余的模板语法解析,仅仅是编译一次
• It is smart about recompiling only the template files that have
changed.
仅对修改过的模板文件进行重新编译
• You can make custom functionsand custom variable modifiers, so the
template language is extremely extensible.
可以编辑'自定义函数'和自定义'变量',因此这种模板语言完全可以扩展
• Configurable template delimiter tag syntax, so you can use {}, {{}},
<!--{}-->, etc.
可以自行设置模板定界符,所以你可以使用{}, {{}}, <!--{}-->, 等等
• The if/elseif/else/endif constructs are passed to the PHP parser,
so the {if ...} expression syntax can be as simple or as complex
as you like.
诸如 if/elseif/else/endif 语句可以被传递到 php 语法解析器,所以
{if ...} 表达式是简单的或者是复合的,随你喜欢啦
• Unlimited nesting of sections, ifs, etc. allowed.
如果允许的话,section 之间可以无限嵌套
• It is possible to embed PHP code right in your template files,
although this may not be needed (nor recommended) since the engine
is so customizable.
引擎是可以定制的.可以内嵌 php 代码到你的模板文件中,虽然这可能并
不需要(不推荐)
• Built-in caching support
内建缓存支持
• Arbitrary template sources
独立模板文件
• Custom cache handling functions
可自定义缓存处理函数
• Plugin architecture
插件体系结构
1. 官方网站下载smarty的版本，这里以2.6.18为基础.解压其中的libs,把libs 全部拷贝到
项目中
2. 下面是配置的代码，新建个index.php文件，代码为：
<?php
//配置环境
include_once "libs/Smarty.class.php"; //引入smarty类文件
$smarty = new smarty();//初始化smarry
$smarty->template_dir = "template";// 设置模板目录
$smarty->compile_dir = "template_c"; //设置编译文件目录
$smarty->cache_dir = "cache"; //设置 缓存目录
$smarty->caching = false; //设置缓存开启标志
$smarty->cache_lifetime = "60"; //设置缓存有效时间
$smarty->left_delimiter = '{'; // 设置左分界符号
$smarty->right_delimiter = '}'; // 设置右分界符号
?>
3．在项目目录中分别新建目录template,template_c,cache,
整体目录结构为：
4．方法介绍
assign (name,value)
赋值 用来赋值到模板中。可以指定一对 名称/数值 ，也可以指定包含 名称/数值 的联合数组。
例子：
// 名称/数值 方式
$smarty->assign("Username","raojinpg");
$smarty->assign("Sex",$Sex);
// 联合数组方式
$smarty->assign(array("city" => "jiangxi","state" => "nanchang"));
Fetch (tpl,cache_id,compile_id) 模板，缓存号，编译号
取得输出内容
// 捕获输出
$output = $smarty->fetch("index.tpl");
display (tpl,cache_id,compile_id) 模板，缓存号，编译号
显示
// 显示
$smarty->display("index.tpl");
is_cached (tpl,cache_id) 模板，缓存号
是否被缓存
// 是否已经被缓存
$smarty->caching = true;
If(!$smarty->is_cached("index.tpl")){
$smarty->display("index.tpl");
}
//多缓存模板
$cache_id = sprintf(‘%X’,crc32($cache_id));
If(!$smarty->is_cached("index.tpl"，$cache_id)){
$smarty->display("index.tpl"，$cache_id);
}
clear_cache (tpl,cache_id,compile_id,inttime) 模板，缓存号，编译号，超出时间
清除某一模板的缓存
//清除某一模板的缓存
$smarty->clear_cache("index.tpl");
//清除多缓存模板
$cache_id = sprintf(‘%X’,crc32($cache_id));
$smarty->clear_cache ("index.tpl"，$cache_id)
clear_all_cache （inttime）超出时间
清除所有缓存
//清除所有缓存
$smarty-> clear_all_cache();
修饰符号
equal : 相等、------------------------------------------------ eq
not equal：不等于、-----------------------------------------ne neq
greater than：大于、-----------------------------------------gt
less than：小于、---------------------------------------------lt
less than or equal：小于等于、----------------------------lte ,le
great than or equal：大于等于、---------------------------gte ,ge
is even：是偶数、
is odd：是奇数、
is not even：不是偶数、
is not odd：不是奇数、
not：非、
mod：取余、
div by：被。。。除
==、!=、>、<、<=、>=
变量调节器
* capitalize [首字符大写]
* count_characters [字符计数]
* cat [连接字符串] cat里的值连接到给定的变量后面.
* count_characters[字符计数] {$articleTitle|count_characters:true}决定是否计算空格字符。
* count_sentences[计算句数]
* count_words[计算词数]
* date_format[格式化日期] {$smarty.now|date_format:"%H:%M:%S"}
* default[默认值] {$myTitle|default:"no title"}
* escape[编码] html,htmlall,url,quotes,hex,hexentity,javascript {$articleTitle|escape:"url"}
* indent[缩进] 在每行缩进字符串，默认是4个字符
* lower [小写]
* nl2br [换行符替换成<br />]
* regex_replace [正则替换] {$articleTitle|regex_replace:"/[\r\t\n]/":" "}
* replace [替换]
* spacify [插空]
* string_format [字符串格式化]
* strip [去除(多余空格)]
* strip_tags [去除html标签]
* truncate [截取]
* upper [大写]
* wordwrap [行宽约束]
函数
Capture
capture函数的作用是捕获模板输出的数据并将其存储到一个变量里,而不是把它们输出到页面.
任何在{capture name="name"}和{/capture}之间的数据将被存储到变量$name中，该变量由name属性指定.
在模板中通过$smarty.capture.name 访问该变量.
如果没有指定name 属性,函数默认将使用"default" 作为参数.
{capture}必须成对出现，即以{/capture}作为结尾,该函数不能嵌套使用.
当希望捕获包含 {insert} 命令的数据时要特别注意. 如果打开了缓存并希望将 {insert} 命令输出到缓中，
不要捕获该区域的数据
{* 该例在捕获到内容后输出一行包含数据的表格，如果没有捕获到就什么也不输出 *}
{capture name=banner}{include file="get_banner.tpl"}{/capture}
{if $smarty.capture.banner ne ""}{$smarty.capture.banner}{/if}
Config_load
该函数用于从配置文件中加载变量{config_load file="colors.conf"} 使用{#变量#}
配置文件内容
配置文件内容
# global variables
pageTitle = "Main Menu"
bodyBgColor = #000000
tableBgColor = #000000
rowBgColor = #00ff00
[Customer]
pageTitle = "Customer Info"
[Login]
pageTitle = "Login"
focus = "username"
Intro = """This is a value that spans more
than one line. you must enclose
it in triple quotes."""
# hidden section
[.Database]
host=my.domain.com
db=ADDRESSBOOK
user=php-user
pass=foobar
///////////////////////////////////////////////模板文件内容
{config_load file="colors.conf"}
<html>
<title>{#pageTitle#}</title>
<body bgcolor="{#bodyBgColor#}">
<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}">
<tr bgcolor="{#rowBgColor#}">
<td>First</td>
<td>Last</td>
<td>Address</td>
</tr>
</table>
</body>
</html>
带section 属性的config_load 函数演示
{config_load file="colors.conf" section="Customer"}
<html>
<title>{#pageTitle#}</title>
<body bgcolor="{#bodyBgColor#}">
<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}">
<tr bgcolor="{#rowBgColor#}">
<td>First</td>
<td>Last</td>
<td>Address</td>
</tr>
</table>
</body>
</html>
PHP
允许模板使用PHP语法
{php}
echo time();
{/php}
Literal
标签区域内的数据将被当作文本处理，此时模板将忽略其内部的所有字符信息. 该特性用于显示有可能包
含大括号等字符信息的javascript 脚本
{literal}
<script>
function fun(){
alert(1);
}
</script>
{/literal}
include
Include 标签用于在当前模板中包含其它模板. 当前模板中的变量在被包含的模板中可用. 必须指定file
属性，该属性指明模板资源的位置.
{include file="header.tpl"}
//可以带参数,
{include file="header.tpl" title="标题"}
Insert
所包含的内容不会被缓存，每次调用该模板都会重新执行该函数.
//php 代码
<?php
Function insert_nocache($array){
//Return time();
Print_r($array);
}
?>
//模板代码
{insert name="nocache" tid="2"}
ldelim,rdelim
ldelim 和rdelim 用于输出分隔符，也就是大括号"{" 和"}". 模板引擎总是尝试解释大括号内的内容，因
此如果需要输出大括号，请使用此方法
if,elseif,else
if 必须于/if 成对出现. 可以使用else 和elseif 子句
{if $name eq "Fred"}
Welcome Sir.
{elseif $name eq "Wilma"}
Welcome Ma'am.
{else}
Welcome, whatever you are.
{/if}
foreach,foreachelse
foreach 是除section 之外处理循环的另一种方案(根据不同需要选择不同的方案).
foreach 用于处理简单数组(数组中的元素的类型一致)，它的格式比section 简单许多，缺点是只能处理简
单数组.
foreach 必须和/foreach 成对使用，且必须指定from 和item 属性.
name 属性可以任意指定(字母、数字和下划线的组合).
foreach 可以嵌套，但必须保证嵌套中的foreach 名称唯一.
from 属性(通常是数组)决定循环的次数.
foreachelse 语句在from 变量没有值的时候被执行.
{* 该例将输出数组 $custid 中的所有元素的值 *}
//php 代码
$smarty->assign('custid',range(1,3));
//tpl
{foreach from=$custid item=curr_id}
id: {$curr_id}<br>
{/foreach}
OUTPUT:
id: 1<br>
id: 2<br>
id: 3<br>.
{*多唯*}
//php 代码
$smarty->assign("contacts",
array(array("phone" => "1", "fax" => "2", "cell" => "3"),
array("phone" => "555-4444", "fax" => "555-3333", "cell" => "760-1234")));
{* 键就是数组的下标，请参看关于数组的解释 *}
//tpl
{foreach name=outer item=contact from=$contacts}
{foreach key=key item=item from=$contact}
{$key}: {$item}<br>
{/foreach}
{/foreach}
OUTPUT:
phone: 1<br>
fax: 2<br>
cell: 3<br>
phone: 555-4444<br>
fax: 555-3333<br>
cell: 760-1234<br>
section,sectionelse
section 用于遍历数组中的数据. section 标签必须成对出现. 必须设置 name 和 loop 属性. 名称可以是包
含字母、数字和下划线的任意组合. 可以嵌套但必须保证嵌套的name 唯一. 变量loop (通常是数组)决定
循环执行的次数. 当需要在section 循环内输出变量时，必须在变量后加上中括号包含着的name 变量.
sectionelse 当loop 变量无值时被执行
index:用于显示当前循环的索引，从0开始(如果指定了start属性，那么由该值开始)，每次加1(如果指定了
step属性，那么由该值决定).如果没有指定step和start属性，此值的作用和iteration类似，只不过从0开始
而已.
index_prev:用于显示上一个循环索引值. 循环开始时，此值为-1.
index_next:用于显示下一个循环索引值. 循环执行到最后一次时，此值仍然比当前索引值大1(如果指定了
step，取决于此值).
iteration:用于显示循环的次数.iteration 不像index属性受start、step和max属性的影响，该值总是从1开始
(index是从0开始的).rownum 是iteration的别名，两者等同.
first:如果当前循环第一次执行，first 被设置为true.
last:如果当前循环执行到最后一次，last 被设置为true.
rownum:用于显示循环的次数. 该属性是iteration的别名，两者等同.
loop:用于显示该循环上一次循环时的索引值. 该值可以用于循环内部或循环结束后.
show:是section 的参数. show 取值为布尔值true 或false. 如果设置为false，该循环将不显示. 如果指定
了sectionelse 子句，该字句是否显示也取决于该值.
total:用于显示循环执行总的次数. 可以在循环中或执行结束后调用此属性.
//一维
{section name=item loop=$array2}
值为:{$array2[item]}
{$item}
{/section}
//一维
{section name=n loop=$people}
name:{$people[n]}<br/>
{/section}
//关联数组
{section name=sn loop=$news}
{if $smarty.section.sn.first}
<table>
<th>id</th>
<th>title</th>
{/if}
<tr>
<td>{$news[sn].id}</td>
<td>{$news[sn].title}</td>
</tr>
{if $smarty.section.sn.last}
</table>
{/if}
{sectionelse}
there is no news.
{/section}
strip
Smarty 在显示前将除区任何位于{strip}{/strip} 标记中数据的首尾空格和回车. 这样可以保证模板容易理
解且不用担心多余的空格导致问题
扩展方法
在smarty中带了比较多的内部方法，如果我们要扩展一个capitalize类似的方法那如何做呢
假定我们的方法为checkemail
首先建立个文件，名称为modifier. checkemail.php
然后代码为
<?php
Function smarty_checkemail($string){
//这里做你自己需要处理的事情
}
?>