Smarty3 笔记By 飞鸿影~2014-9-23 21:46:38
Smarty入门
1、什么是smarty？
Smarty是采用php写的一个模版引擎，设计的目的是要将php代码与html代码分离， 使php程序员只专注于php代码的编写，网页美工只专注于网页的美化2、采用模版引擎后: 1)php代码与html代码分离开了，php代码放在一个单独的php文件中，html代码放在一个单独的html文件中 2)数据的传递首现php中的数据先给了模版引擎，然后模版引擎再把接收到的数据给模版文件显示。 3)模版文件中不再有php代码或者说php标记的出现，模版中显示的数据都是通过模版引擎的标记显示出来的index.php -> smarty模版引擎 -> index.html
3、Smarty的优点:
1)速度快：相对于其它的模版引擎而言的 2)编译型：支持缓存技术,无需每次重新编译(在模版文件没有改动的情况下) 3)模版中可以使用流程控制语句。4、Smarty模版引擎运作流程 ①在php程序运行时，初始化smarty模版引擎 ②smarty模版引擎读取模版文件(.html或tpl文件) ③在读取模版文件的时候，smarty模版引擎会自动判断该模版文件是否需要重新编译。 ④如果不需要重新编译，则直接进行模版变量替换。 ⑤如果是第一次执行此程序文件或者说模版被改动了，那么就需要重新编译后再进行模版变量替换。 ⑥最终执行的是编译后的php文件。 ⑦输出结果到浏览器。5、如何获得Smarty： 到官方网站去下载smarty模版引擎压缩包 官网： 解压后将libs目录拷贝至项目开发目录6、搭建Smarty模板示例： 1)将libs库目录复制过来。 2)创建一个模板目录templates模板文件存放目录 创建一个configs配置文件目录 3)编写index.php文件（入口文件）做Smarty导入和创建;templates目录中新建index.html模板文件 ++ index.php assign("name","zhangsan"); //向Smarty模板中分配变量name=zhangsan $smarty->display("index.html"); //使用index.html显示?>
++ index.html
{$name} [小提示]
assign():主要用来将php中的标量类型的数据赋值给模版变量 display():主要用来显示指定的模版文件,可以指定路径[模板中如何显示分配的变量?] 一般的变量,使用 {$var} 形式.例如我们这里分配的name=zhangsan, 我们在模板index.html中使用 {$name} 显示. 后面会讲述更多关于模板变量显示的内容. 4)使用浏览器访问index.php,将会创建目录templates_c和cache目录 5)最后的结构：根目录 |--libs //Smarty库 | |--Smarty.class.php |--templates //模板目录 | |--index.html |--templates_c //模板编译目录 |--cache //模板静态缓存目录（注意需开启缓存） |--configs //配置文件目录 |--index.php //php文件（入口）
6)其他可选配置项(不改即为默认值):
//配置$smarty->debugging=false; //是否开启debug调试$smarty->template_dir="templates/"; //模板目录$smarty->compile_dir="templates_c/"; //编译目录$smarty->config_dir="configs/"; //配置项目录$smarty->cache_dir="cache/"; //缓存目录$smarty->caching=false; //是否开启缓存$smarty->cache_lifetime=3600; //缓存生命周期,单位是s$smarty->left_delimiter="{"; //左定界符$smarty->right_delimiter="}"; //右定界符
7、Smarty应用之模版变量
通常分配的变量有：字符串、数字、数组、对象 [例]2.php:$smarty->assign("title","Smarty模板引擎实例--变量输出");//字符串$smarty->assign("num",100);//数字$smarty->assign(array("name"=>"zhangsan","age"=>23));//多个值$smarty->assign("a1",array(10,20,30));//索引数组$smarty->assign("a2",array("name1"=>"zs","name2"=>"zs2"));//关联数组$smarty->assign("ob",new Demo());//对象,含有公共属性name和age,为了节约篇幅,这里省略了类
模板里访问分配的变量(templates/2.html):
{$title}
- 返回首页
- ^_^{*注释的内容不会被输出*}
- 输出一个数值:{$num},{$num*2}
- 输出一个字符串:{$title},长度:{strlen($title)}
- 输出一个数组里面的批量值:{$name},{$age}
- 输出一个索引数组a1:{$a1[0]},{$a1[1]},{$a1[2]}
- 输出一个关联数组a2:{$a2['name1']},{$a2['name2']}
- 输出一个关联数组a2:{$a2.name1},{$a2.name2}
- 输出一个对象:{$ob->name},{$ob->age}
8、模板里php函数使用(一般是return有结果的函数才直接使用)
(templates/3.html):当前时间{date("Y-m-d H:i:s")}自定义函数：{fun()}
**其中自定义函数在3.php中是
function fun(){ return "hehe";} 9、模板里超全局变量使用(templates/4.html):
**当然,得提前在4.php中定义才行：
$_SESSION['name']="admin";$_GET['id']=100;$_POST['name']="yjc";const PI=3.14;
更多还支持:
诸如 $_GET, $_POST,$_COOKIE, $_SERVER, $_ENV and $_SESSION 都可以使用 {$smarty.post.get} 类似 方法输出,记得改为小写10、模板从configs/目录读取配置文件 模板里读取格式： {config_load file="lang.conf" section="en"} 其中section为可选项,配置文件后缀一般是conf,ini等 举例说明配置文件格式(configs/user.conf)[users]username=zhangsanage=22
模板里使用配置文件定义的变量方法是:
{$smarty.config.username}或者{#username#}{$smarty.config.age}或者{#age#} 11、模板里包含文件 例如包含当前目录下menu.html
{include file="menu.html"} 12、模板里foreach遍历数组 Smarty3.0新版使用格式(与php原生的基本一样)：
{foreach $data as $key=>$value} {$value.name} {$value.age}{/foreach}
Smarty3.0同时兼容旧版使用方法：
{foreach from=$data key="key" item="value"}{/foreach}
[实践]
当然,我们可以连接数据库后,使用之前写的Model.class.php数据库操作类写一个学生信息管理系统. 通过使用switch,可以实现单个页面display多个页面,很类似ThnkPHP控制器的雏形. 大概思路：switch($_GET['a']){ case "add"://添加信息表单 $smarty->display("stu/add.html"); break; case "insert"://执行添加信息 break; case "edit"://修改信息表单 $smarty->display("stu/edit.html"); break; case "update"://执行更新信息 break; case "del"://删除信息 break; case "index": default://浏览信息 $s->smarty("stu/index.html");}
Smarty高级
1、Smarty保留变量
{ $smarty.now} 当前时间戳,同{ $time()}{ $smarty.const} 输出系统已定义常量,后面加上常量名{ $smarty.capture} 捕获标签{capture name="mycap"}一些内容{/capture}里的内容,这里使用{ $smarty.capture.mycap}读取{ $smarty.config} 读取配置文件(如my.conf)里变量,后面加变量名。等效{ #变量名#}{ $smarty.section} (后续课程模板继承里讲解){ $smarty.template} 当前模板名(不包括目录){ $smarty.current_dir} 当前模板目录{ $smarty.version} 当前Smarty版本{ $smarty.block.child} (后续课程模板继承里讲解){ $smarty.block.parent} (后续课程模板继承里讲解){ $smarty.ldelim}, { $smarty.rdelim} 输出当前左、右定界符 当然,在上一节内容,我们还学习了 { $smarty.get},{ $smarty.post},{ $smarty.session},{ $smarty.cookie},{ $smarty.server},{ $smarty.env},{ $smarty.request} 等PHP全局变量.
2、Smarty变量调节器
1)系统提供的调节器(*号标注表示使用较多.大部分使用频率不高,了解即可)：
*capitalize [首字符大写] cat [连接字符串] count_characters [字符计数] count_paragraphs [计算段数] count_sentences [计算句数] count_words [计算词数] *date_format [格式化日期] default [默认值] escape [转义] indent [缩进] lower [小写] *nl2br [换行符替换成 ] regex_replace [正则替换] *replace [替换] spacify [插空] string_format [字符串格式化] strip [去除(多余空格)] strip_tags [去除html标签] *truncate [截取] *upper [大写] wordwrap [行宽约束]
使用方法示例(2.html)：
2)自定义调节器(采用插件文件方式):
a)在smarty模板的libs/plugins/目录下创建调节器： 调节器文件名：modifier.调节器名.php 注意：若是自定义的的调节器不在libs/plugins/目录下,需要使用下面Smarty的方法追加。 如： smarty->addPluginsDir("./libs/myplugins");//追加一个插件目录的方式 注意清除编译缓存目录 b)在这个文件里的函数名：function smarty_modifier_调节器函数名(参数列表...){ //..... } 例如：
/*** 自定义调节器：字符串截取函数* 参数：* $str:表示被截取的字符串* $len:保留字串的长度值。默认值：10*/function smarty_modifier_mystr($str,$len=10){ if(strlen($str)>$len){ return substr($str,0,$len)."..."; }else{ return $str; }}
注意：在使用是,要按函数的参数顺序来。
c)使用 { $str|调节器名}练习：自定义一个调节器： myfont($str,$size,$color)
如： { $str|myfont:7:"red"} =>输出： <font size="7" color="red">$str</font> 3)自定义调节器(采用注册调节器方式)： 除了上面的方法外还有一个方式可以定义一个变量的调节器 使用Smarty的一个方法： registerPlugin("modifier","调节器名", "被指定的函数名"); 例如：$smarty->registerPlugin("modifier","mystrlen","strlen");//注册一个调节器的函数 { $str|mystrlen} //输出str字串的长度 4)组合调节器：
{ $articleTitle}{ $articleTitle|upper|spacify}{ $articleTitle|lower|spacify|truncate}{ $articleTitle|lower|truncate:30|spacify}{ $articleTitle|lower|spacify|truncate:30:". . ."}
3、Smarty中的函数
(标注*号为实用的)
格式：{函数名 属性1="值1" 属性2="值2" }{ /函数名} 1)内置函数
* {assign} 在模板中定义并变量,并赋值 示例：{assign var="name" value="Bob"}{assign "name" "Bob"} {* 简写 *} * { $var=} 简写模板中定义变量(同assign), 示例：
{ $name='Bob'}{ $user.name="Bob"}{ $users[]="Bob"} {append} 在模板执行期间建立或追加模板变量数组。
示例：对数组name追加成员值{append var='name' value='Bob' index='first'} { function} 用来在模板中创建函数,可以像调用插件函数一样调用它们。 {call} 用来调用{function}标签定义的模板函数 {capture} 用来捕获模板输出的数据并将其存储到一个变量里,而不是将它们输出到页面。 * {config_load} 载入配置文件：用来从配置文件(位于configs目录)中加载config变量(#variables#)到模版。 示例：
{config_load file="lang.conf" section="en"} {debug} 显示调试控制台
* { for} 简单的循环 { for} 标签用来创建一个简单循环,支持 {forelse} 分支标签且支持以下不同的格式：{ for $var=$start to $end}步长为1的简单循环； { for $var=$start to $end step $step}其它步长循环。 示例：
- { for $foo=1 to 3}
- { $foo} { /for}
* { foreach},{foreachelse}
3.x版格式：
{ foreach $data as [$k=>]$v}//输出$k / $v{/foreach} 2.x版格式(仍然兼容)
{ foreach from=$data item="v" key="key"}{ /foreach} * { if},{ elseif},{ else}
每一个{if}必须与一个{/if}成对出现，允许使用{else}和{elseif}。 所有php条件和函数在这里同样适用，诸如||、or、&&、and、is_array()等等。 例如：{ if $name == 'Fred' || $name == 'Wilma'}...{ /if} *{include} 包含其他模板
例如：{ include file="header.html"}{ include file="sider.html"} {insert}标签类似于{include}标签,不同之处是即使打开caching,它所包含的内容也不会被缓存,每次调用模板都会执行.
该特性可以广泛应用于广告条、投票、实时天气预报、搜索结果、反馈信息等区域。{* 获取一个横幅广告示例 *}{insert name="getBanner" lid=#banner_location_id# sid=#site_id#} {block} 用来定义一个命名的模板继承源区域。
{extends} 标签用在模板继承中子模版对父模板的继承。 {ldelim},{rdelim} 用来转义模版定界符,默认值为"{"和"}"。 *{literal} 标签区域内的数据将按字面意思处理,代表性地是用在javascript/css语块周围 {nocache} 用来禁止模版块缓存,每个{nocache}应与{/nocache}成对出现。 {php},{include_php}已被Smarty弃用,不应再使用。还是用你自己编写的php脚本或插件函数来代替它吧！ *{section},{sectionelse} {while} 2)Smarty扩展函数(Smarty自定义的,使用频率不高,了解即可){counter} {cycle} { eval} {fetch} {html_checkboxes} {html_image} {html_options} {html_radios} {html_select_date} {html_select_time} {html_table} {mailto} {math} {textformat}
4、缓存
1)配置开启缓存
$smarty = new Smarty;$smarty->caching = true;//开启缓存$smarty->cache_lifetime = 3600;//缓存开启1小时
一般不建议全站开启缓存,哪个页面需要就开启哪个。
所以,不要把缓存配置写在公共配置文件里 2)Smarty里缓存相关方法isCached() 检测模板是否具有有效缓存clearCache() 清除指定模板缓存clearAllCache() 清除整个模板缓存
3)使用情况示例
比如学生信息的增删查改操作,我们在查询时可以缓存：if(!$smarty->isCached("index.html")){$data=$m->select();$smarty->assign("data",$data);}$smarty->display("index.html"); 对于增删改,我们不应该使用缓存,所以在执行相关操作成功后,应该清除缓存：
if($res){ $smarty->clearCache("index.html");} 但是这样还有个Bug,就是你不管修改哪个用户数据,进入edit页面,表单里数据不变。
那么这时候只能使用多级缓存了,用户修改页面就要这样写了:if(!$smarty->isCached("stu/edit.html",$_GET['id'])){ $stu = $mod->find($_GET['id']); $smarty->assign("data",$stu);}$smarty->display("stu/edit.html",$_GET['id']); 那么update更新成功后应该清除两个缓存：
$smarty->clearCache("index.html"); //清除浏览缓存$smarty->clearCache("edit.html",$_POST['id']); //清除修改表单缓存