首页 > 代码库 > smarty模板基础

smarty模板基础

2024-09-17 12:56:20   218人阅读

smarty模板的核心是一个类，下载好的模板中有这么几个重要的文件夹

（1）libs核心文件夹
（2）int.inc.php这是入口文件
（3）plugins：自己写的插件文件夹
（4）templates_c：存放编译好的文件
（5）int.inc.php这是入口文件
（6）定义好常量：不能修改

一、如何实现前后分离的原理：
核心是一个类
1.左分隔符{
2.右分隔符}
3.数组（默认空数组）：存储变量

4.提供一个方法：向模板中注册变量的方法（assign（名字，值））
方法存在数组中的（找到数组存入变量）

5.还有一个方法：显示模板的（display（模板的名称或是路径））
两个功能：拿模板，解析变量

通过名称就可以找到模板的路径
$url = "模板路径".$name ;

读取模板文件，返回字符串
$str = file_get_contents($url);

将字符串的某些内容作了替换
1.将模板中的"名字"替换成 一段php代码 echo $arr=[名字] 
2.将替换好的字符串保存到临时文件或者是编译好的文件
file_put_contents(存放的位置，上面替换好的字符串);
3.将编译好的文件拿到当前页面显示
include(临时文件的目录);

二、怎么用模板？

模板页面
1.引入模板的入口文件
include("入口文件路径位置");

2.直接用对象
提供一个方法：向模板中注册变量的方法（assign（名字，值）
$smarty->assign("ceshi","你好");
提供一个方法：显示模板的（display（模板的名称或是路径））
$smarty->display("ceshi.html");


正常页面
{assign(名字)}

注意：
1.访问的是php的页面，显示的是html页面
2.html用到了外部的样式表，位置是相对于访问的php页面来找外部样式

三、入口文件的内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<?php
 
define("ROOT",str_replace("\\","/",dirname(__FILE__)).‘/‘); //常量ROOT中指定项目根目录
 
//echo str_replace("\\","/",dirname(__FILE__)).‘/‘; //获取当前文件所在的位置
 
require ROOT.‘libs/Smarty.class.php‘; //加载Smarty类文件
$smarty = new Smarty(); //实例化Smarty对象
 
 
define("CSS_PATH","/project/css/");
define("JS_PATH","/project/js/");
 
//$smarty -> auto_literal = false; //就可以让定界符号使用空格
$smarty->setTemplateDir(ROOT.‘templates/‘); //设置所有模板文件存放位置
//$smarty->addTemplateDir(ROOT.‘templates2/‘); //添加一个模板文件夹
$smarty->setCompileDir(ROOT.‘templates_c/‘); //设置编译过的模板存放的目录
$smarty->addPluginsDir(ROOT.‘plugins/‘); //设置为模板扩充插件存放目录
$smarty->setCacheDir(ROOT.‘cache/‘); //设置缓存文件存放目录
$smarty->setConfigDir(ROOT.‘configs/‘); //设置模板配置文件存放目录
 
$smarty->caching = false; //设置Smarty缓存开关功能
$smarty->cache_lifetime = 60*60*24; //设置缓存模板有效时间一天
<br>//下面的内容是修改左和右的分隔符形式
$smarty->left_delimiter = ‘<{‘; //设置模板语言中的左结束符
$smarty->right_delimiter = ‘}>‘; //设置模板语言中的右结束符
 
?>

四、一些注意的点

（1）smarty注释

模板注释被*星号包围，而两边的星号又被定界符包围：

例如： 

1
{* this is a comment *}

注意：smarty注释不会在模板文件的最后输出中出现，这与<!-- HTML 注释-->不同（译注：html注释在页面源码中可见，而smarty注释则不能）也就是：注释只存在于模板里面，而在输出的页面中谁也看不见。　

（2）从配置文件读取的变量

配置文件的内容：

1
2
3
4
5
6
7
config file - foo.conf:
 
pageTitle = "This is mine"
bodyBgColor = ‘#eeeeee‘
tableBorderSize = 3
tableBgColor = "#bbbbbb"
rowBgColor = "#cccccc"

主页中写的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
//下面为配置文件变量“井号方法”的示例
{config_load file=‘foo.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>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//下面为$smarty.config方法的示例：
 
{config_load file=‘foo.conf‘}
<html>
<title>{$smarty.config.pageTitle}</title>
<body bgcolor="{$smarty.config.bodyBgColor}">
<table border="{$smarty.config.tableBorderSize}" bgcolor="{$smarty.config.tableBgColor"}>
<tr bgcolor="{$smarty.config.rowBgColor}">
<td>First</td>
<td>Last</td>
<td>Address</td>
</tr>
</table>
</body>
</html>

（3）加载配置文件后，配置文件中的变量需要用两个井号"#"包围或者是smarty的保留变量$smarty.config.来调用

{$smarty.now}取得当前时间戳，可以直接通过变量调节器date_format[格式化日期]输出显示

date_format转换标记：

  • %a - 当前区域星期几的简写
  • %A - 当前区域星期几的全称
  • %b - 当前区域月份的简写
  • %B - 当前区域月份的全称
  • %c - 当前区域首选的日期时间表达
  • %C - 世纪值（年份除以 100 后取整，范围从 00 到 99）
  • %d - 月份中的第几天，十进制数字（范围从 01 到 31）
  • %D - 和 %m/%d/%y 一样
  • %e - 月份中的第几天，十进制数字，一位的数字前会加上一个空格（范围从 ‘ 1‘ 到 ‘31‘）
  • %g - 和 %G 一样，但是没有世纪
  • %G - 4 位数的年份，符合 ISO 星期数（参见 %V）。和 %V 的格式和值一样，只除了如果 ISO 星期数属于前一年或者后一年，则使用那一年。
  • %h - 和 %b 一样
  • %H - 24 小时制的十进制小时数（范围从 00 到 23）
  • %I - 12 小时制的十进制小时数（范围从 00 到 12）
  • %j - 年份中的第几天，十进制数（范围从 001 到 366）
  • %m - 十进制月份（范围从 01 到 12）
  • %M - 十进制分钟数
  • %n - 换行符
  • %p - 根据给定的时间值为 `am‘ 或 `pm‘，或者当前区域设置中的相应字符串
  • %r - 用 a.m. 和 p.m. 符号的时间
  • %R - 24 小时符号的时间
  • %S - 十进制秒数
  • %t - 制表符
  • %T - 当前时间，和 %H:%M:%S 一样
  • %u - 星期几的十进制数表达 [1,7]，1 表示星期一
  • %U - 本年的第几周，从第一周的第一个星期天作为第一天开始
  • %V - 本年第几周的 ISO 8601:1988 格式，范围从 01 到 53，第 1 周是本年第一个至少还有 4 天的星期，星期一作为每周的第一天。（用 %G 或者 %g 作为指定时间戳相应周数的年份组成。）
  • %W - 本年的第几周数，从第一周的第一个星期一作为第一天开始
  • %w - 星期中的第几天，星期天为 0
  • %x - 当前区域首选的时间表示法，不包括时间
  • %X - 当前区域首选的时间表示法，不包括日期
  • %y - 没有世纪数的十进制年份（范围从 00 到 99）
  • %Y - 包括世纪数的十进制年份
  • %Z 或 %z - 时区名或缩写
  • %% - 文字上的 `%‘ 字符 

例如：　

1
2
3
4
<?php
$config[‘date‘] = ‘%I:%M %p‘;
$smarty->assign(‘config‘, $config);
?>

正常页面中的

1
2
3
{$smarty.now|date_format}
{$smarty.now|date_format:"%D"}
{$smarty.now|date_format:$config.date}

根据上面的字母提示可以算出输出信息。

 

 

Smarty自带了一些内置函数，这些内置函数是Smarty模板引擎的组成部分。他们被编译成相应的内嵌PHP代码，以获得最大性能。

您创建的自定义函数不能与内置函数同名，也不必修改这些内置函数。

其中一些具有assign属性，用来收集函数结果，并将结果分配给一个命名的模板变量，而不是将内容输出，类似于{assign}函数。

一、{if}{elseif}{else} 条件

随着一些特性加入到模版引擎，Smarty的{if}语句与php的if语句一样富有弹性。每一个{if}必须与一个{/if}成对出现，允许使用{else}和{elseif}，所有php条件和函数在这里同样适用，诸如||、or、&&、and、is_array()等等。

如果开启安全，只支持符合$php_functions的安全策略属性的php函数。
下面是一串有效的限定符，它们的左右必须用空格分隔开，注意列出的清单中方括号是可选的，在适用情况下使用相应的等号（全等或不全等）。

技术分享

（1）{if}语句（开头结尾不要忘记）

先要在php页面引入“入口文件”，写入“变量注册方法”和“模板显示方法”

1
2
3
4
5
6
7
<?php
include("../init.inc.php");  //引入的入口文件
 
 
$smarty->assign("name",10);  //变量注册方法assign()
 
$smarty->display("test.html");  //模板显示方法display()

然后是html页面的条件了

1
2
3
4
5
6
7
<!--开头if-->
<{if $name == 10}>  <!--如果$name等于10-->
 
<div style="width:100px; height:100px; "></div> <!--这个div的颜色是红色-->
 
<!--结尾if-->
<{/if}>

看下结果

技术分享

修改一下php文件中的注册值

1
$smarty->assign("name",11);

那么这个div就不会显示了，因为条件是$name等于10的时候才会显示红色

（2）{if}...{else}语句　

php页面还是上面的例子，不同的是html页面加了一个“否则”的语句

1
2
3
4
5
6
7
8
<!--开头if-->
<{if $name == 10}>    <!--如果$name等于10，这个div就是红色-->
<div style="width:100px; height:100px; "></div>
<!--否则-->
<{else}>    <!--否则这个div是粉色-->
<div style="width:100px; height:100px; "></div>
<!--结尾if-->
<{/if}>

刚开始在php中name的值是“10”，所以也看到了颜色是红色；现在我们把name的值成随便一个数，那么html中的如果就不会成立，那么就会出现“否则”的颜色

技术分享

注意：上面的那个表中相对的“备用词”也是可以用的。

二、{foreach},{foreachelse}遍历

（1）同样，要先写php文件，既然是遍历，那么我们可以用数组

1
2
3
4
5
6
7
8
9
10
11
12
13
<?php
include("../init.inc.php");
 
$arr = array(
    array("001","中国"),
    array("002","淄博"),
    array("003","济南"),
    array("004","济宁"),
);
 
$smarty->assign("shuzu",$arr);
 
$smarty->display("test.html");

（2）然后就是写html页面了，{foreach}也是双标签啊，这里使用下拉列表显示出来的

1
2
3
4
5
6
7
<select>
        <{foreach $shuzu as $v}>
                <option value=http://www.mamicode.com/"<{$v[0]}>"><{$v[1]}></option>
        <{/foreach}>
         
</select>
        

看下显示结果

技术分享

（3）嵌套了key的{foreach}

php页面没有任何变换，变换的是html页面

不同的是as后面的代码

1
2
3
4
5
<select>
　　<{foreach $shuzu as $k=>$v}>   <!--不同之处就是$k=>$v-->
　　　　<option value=http://www.mamicode.com/"<{$v[0]}>"><{$k}><{$v[1]}></option>
　　<{/foreach}>      
</select>

这样就是显示出代号了

技术分享

（4）@index

包含当前数组的下标，开始时为0。

同样的将html页面中的key进行修改

1
2
3
4
5
<select>
        <{foreach $shuzu as $v}>
                <option value=http://www.mamicode.com/"<{$v[0]}>"><{$v@index }><{$v[1]}></option>
        <{/foreach}>
</select>

效果是同样的

技术分享

同样的还有一些差不多的

@iteration  ：iteration包含当前循环的迭代，总是以1开始，这点与index不同。每迭代一次值自动加1。

@first  ：当{foreach}循环第一个时first为真。这里我们演示当第一次迭代表格头所在行。

三、编辑器插件

这个就是关于编辑器的文件：技术分享

根据提示可以修改任何的参数对编辑器进行修改

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<?php
 
　　/**
     * 编辑器
     * @param int $textareaid
     * @param int $toolbar    有basic full 和desc三种
     * @param int $color 编辑器颜色
     * @param string $alowuploadexts 允许上传类型
     * @param string $height 编辑器高度
     * @param string $disabled_page 是否禁用分页和子标题
　　*/
　　function smarty_block_textarea($args, $content, $smarty, &$repeat) {
　　//public static function editor($textareaid = ‘content‘, $toolbar = ‘basic‘, $height = 200, $color = ‘‘, $up=true) {
 
　　if(!$repeat) {   
    $textareaid = !empty($args[‘name‘]) ? $args[‘name‘] : ‘content‘;
    $toolbar = !empty($args[‘toolbar‘]) ? $args[‘toolbar‘] : ‘basic‘;
    $height = !empty($args[‘height‘]) ? $args[‘height‘] : ‘200‘;
    $color = !empty($args[‘color‘]) ? $args[‘color‘] : ‘‘;
    $up = !empty($args[‘up‘]) ? $args[‘up‘] : true;
             
 
     
    $str =‘<textarea name="‘.$textareaid.‘">‘.$content.‘</textarea>‘;
    if(!defined(‘EDITOR_INIT‘)) {
        $str .= ‘<script type="text/javascript" src="http://www.mamicode.com/js/ckeditor/ckeditor.js"></script>‘;
        define(‘EDITOR_INIT‘, 1);
    }
     
    if($toolbar == ‘basic‘) {
        $toolbar = "[‘Bold‘, ‘Italic‘,‘Underline‘,‘Strike‘,‘NumberedList‘, ‘BulletedList‘, ‘TextColor‘,‘BGColor‘, ‘Link‘, ‘Unlink‘, ‘-‘, ‘Image‘,‘Flash‘,‘Table‘,‘Smiley‘,‘SpecialChar‘],[‘RemoveFormat‘],
           \r\n";
    } elseif($toolbar == ‘full‘) {
        $toolbar = "[‘Source‘,‘-‘,‘Templates‘],
        [‘Cut‘,‘Copy‘,‘Paste‘,‘PasteText‘,‘PasteFromWord‘,‘-‘,‘Print‘],
        [‘Undo‘,‘Redo‘,‘-‘,‘Find‘,‘Replace‘,‘-‘,‘SelectAll‘,‘RemoveFormat‘],[‘ShowBlocks‘],[‘Image‘,‘Capture‘,‘Flash‘],[‘Maximize‘],
        ‘/‘,
        [‘Bold‘,‘Italic‘,‘Underline‘,‘Strike‘,‘-‘],
        [‘Subscript‘,‘Superscript‘,‘-‘],
        [‘NumberedList‘,‘BulletedList‘,‘-‘,‘Outdent‘,‘Indent‘,‘Blockquote‘],
        [‘JustifyLeft‘,‘JustifyCenter‘,‘JustifyRight‘,‘JustifyBlock‘],
        [‘Link‘,‘Unlink‘,‘Anchor‘],
        [‘Table‘,‘HorizontalRule‘,‘Smiley‘,‘SpecialChar‘],
        ‘/‘,
        [‘Styles‘,‘Format‘,‘Font‘,‘FontSize‘],
        [‘TextColor‘,‘BGColor‘],
        [‘attachment‘],\r\n";
           
    } elseif($toolbar == ‘desc‘) {
        $toolbar = "[‘Bold‘, ‘Italic‘, ‘-‘, ‘NumberedList‘, ‘BulletedList‘, ‘-‘, ‘Link‘, ‘Unlink‘, ‘-‘, ‘Image‘, ‘-‘,‘Source‘],\r\n";
         
    } else {
        $toolbar = ‘‘;
    }
    $str .= "<script type=\"text/javascript\">\r\n";
    $str .= "CKEDITOR.replace( ‘$textareaid‘,{";
 
    $str .= "height:{$height},";
     
     
    if($color) {
        $str .= "extraPlugins : ‘uicolor‘,uiColor: ‘$color‘,";
    }
    /*
    if($up) {  
        $str .="filebrowserImageUploadUrl:‘".B_URL."/upimage‘,";
        $str .="filebrowserFlashUploadUrl:‘".B_URL."/upflash‘,";
    } */
    $str .= "toolbar :\r\n";
    $str .= "[\r\n";
    $str .= $toolbar;
    $str .= "]\r\n";
    //$str .= "fullPage : true";
    $str .= "});\r\n";
    $str .= ‘</script>‘;
    return $str;
　　}
　　}

可以显示出编辑器来看下，同样的在html文件中写

1
2
3
<{textarea}>
         
<{/textarea}>

这样就可以加载出编辑框了

技术分享

（1）在上面的插件中有这么一句注释

1
* @param int $toolbar    有basic full 和desc三种

这样是可以直接在html中进行修改编辑框显示的功能，将toolbar的值改成“full”

1
2
3
<{textarea name=‘uid‘ toolbar=‘full‘}>
         
<{/textarea}>

看下结果：比没有改值的时候的功能多了点

技术分享

通过一些参数还可以修改其他的样式：比如颜色，那么就在后面加上

1
color=‘#F0F‘

就可以变成想要的颜色

技术分享

smarty模板基础


联系
我们