php-smarty-精华

http://www.smarty.net/ http://smarty.php.net/manual/en/

配置

define("ROOTPATH",dirname(__FILE__)."/../");
require_on

ce("smarty/Smarty.class.php");

/**
* Smarty Template Class Initializtion
*/
if( @constant( "ENABLED_TPL" ) ) {
$obj_smarty = new Smarty();
$obj_smarty->compile_check = true; //Open Compile Check
$obj_smarty->debugging = false;// false || DEBUG || DEBUG_TPL; //debug On-off
$obj_smarty->template_dir = ROOT_PATH."html"; //Set Template Document Root
$obj_smarty->compile_dir = ROOT_PATH."cache"; //Set Template Cache File Document Root
$obj_smarty->left_delimiter = "<!!"; //Set Template Left Delimiter
$obj_smarty->right_delimiter = "!!>"; //Set Template Right Delimiter
/**
* 0：Smarty默认值，表示不对模板进行缓存
* 1：表示Smarty将使用当前定义的cache_lifetime来决定是否结束cache
* 2：表示Smarty将使用在cache被建立时使用cache_lifetime这个值
* 习惯上使用true与false来表示是否进行缓存
*/
$obj_smarty->caching = true;
$obj_smarty->cache_lifetime = 60 * 60 * 24;//-1:缓存从不过期,0:每次执行缓存总是被重新建立
}

循环,section,sectionelse

<!!sectionelse!!> 用来表示传入的数组变量为空时对模板进行的处理。

<!!section name=one loop=$arr_result start=5 step=2 max=3 show=$show_customer_info!!>
<!!$arr_result[one].name!!>
<!!$smarty.section.one.iteration!!> //display the current loop iteration
<!!$smarty.section.one.index!!>     //display the current loop index, starting with zero
<!!$smarty.section.one.first!!>     //first is set to true if the current section iteration is the first one
<!!$smarty.section.one.last!!>      //last is set to true if the current section iteration is the last one.
<!!$smarty.section.one.loop!!>      //display the last index number that this section looped
<!!$smarty.section.one.show!!>      //show is a boolean value, true or false
<!!$smarty.section.one.total!!>     //display the number of iterations that this section will loop
<!!$smarty.section.name.rownum+$offset!!>//display the current loop iteration, starting with one $offset为基值
<!!/section!!>

<!!section name=one loop=$arr_result!!>
<input type="checkbox" name="<!!$name!!>[]" id="<!!$name!!>_<!!$smarty.section.one.index+1!!>" value="<!!$arr_result[one].value!!>"
<!!if ($arr_result[one].value|inarray:$arr_values) !!>checked<!!/if!!>/><!!$arr_result[one].value!!>
<!!/section!!>

<!!section name=one loop=$arr_result!!>
<option value="<!!$arr_result[opt].value!!>" <!!if $arr_result[one].value==$selectedvalue !!>selected<!!/if!!>><!!$arr_result[one].option!!></option>
<!!/section!!>

表格排版 1行2列

<!!if $smarty.section.one.index%2 eq 0 !!>
<!!if $smarty.section.one.index%2 eq 1 !!>

奇偶数用于斑马线效果

<!!if $smarty.section.one.rownum%2 eq '0'!!>…<!!else!!>…<!!/if!!>

生成斑马线

<div style="background:<!!cycle values='#F0F8FF,#F0FFFF,#FFFAF0,#F0FFF0'!!>" id="div_msg_<!!$smarty.section.one.rownum!!>">
    …
</div>

表格,html_table table_foreach

<!!html_table cols=4 table_attr=' width="95%" border="0" cellspacing="0"
cellpadding="2" ' tr_attr=' align="left" valign="top" ' td_attr=' width="25%" ' loop=$arr_result!!>

<!!table_foreach from=$addproducts item=sam key=id cols=4 table_attr='width="100%" border="0" cellspacing="4"
cellpadding="0"' tr_attr=" td_attr=' width="25%"align="center" valign="'!!>

<a href="<!!$sam.adurl!!>">
    <img src="upload/images/<!!$sam.adpic!!>" alt="<!!$sam.adalt!!>"
    width="100" height="100" border="0" class='picline'></a>
<a href="<!!$sam.adurl!!>" title="<!!$sam.adalt!!>"><!!$sam.adtitle|substrgb:'0':'20':"!!></a>

    <!!/table_foreach!!>

包含文件,include

<!!include file="header.tpl"!!>

5.不解析,literal

<!!literal!!> 这里是js或css,模板不解析 <!!/literal!!>

6.条件判断,if,elseif,else

<!!if $name eq "Fred" and ($type eq '1' || $type eq '2')!!>
    Welcome Sir.
    <!!elseif $name eq "Wilma"!!>
    Welcome Ma'am.
    <!!else!!>
    Welcome, whatever you are.
    <!!/if!!>

"eq", "ne","neq", "gt", "lt", "lte", "le", "gte" "ge","is even","is odd",
"is not even","is not odd","not","mod","div by","even by","odd by","==","!=",">", "<","<=",">="

字符替换,replace
|replace:"1":"2" 1–将被替换的字符串 2–用来替换的文本 <!!$articleTitle|replace:"pear":"apple"!!>
去除Html标签,strip_tags
去除Html标签去除在<和>之间的所有标签,包括<和>.

<!!$articleTitle|strip_tags!!>

字符截取,truncate,substrgb,mbstrutf8

截取|truncate:"1":"2":"3"
1–指定截取多少字符
2–截取后加在截取词后的字符串
3–检查是否截取到词的边界 Default(false)
<!!$articleTitle|truncate:30:"…":true!!> <!!$articleTitle|substrgb:"0":"23":".."!!> <!!$arr_story[$top18].rm_title|mbstrutf8:"0":"34":"…"!!>

<!!$arr_result[one].SP_CONTENTS|substrgb:"0":"16":"…"!!> 可以解决中文截取乱码问题

注释,Comments

注释 <!! this is a comment !!>

10:日期格式,date_format

日期格式

<!!$smarty.now|date_format!!>
<!!$smarty.now|date_format:"%Y/%m/%d"!!>
<!!$smarty.now|date_format:"%Y-%m-%d"!!>
%y：显示两位数字年份, 00 至 99
%Y：显示四位数字年份
%m：显示数字月份,01-31
%b：显示英文月份,简称
%B：显示英文月份,全称
%d 显示数字日份,01-31
%D 显示英文日份,简称3 个字母 Mon 到 Sun

11:日期下拉列表,html_select_date

日期下拉列表 <!!html_select_date prefix="StartDate" start_year="-5" end_year="+5" field_order="YMD" month_format="%m" display_days=false time="$time"!!> time="2006-06-06" 可以给定输出想要的值

12:循环,foreach,foreachelse

选择性的section循环
from 需要循环的数组的名称
item 当前元素的变量名
key 当前关键字的变量名
name 访问foreache属性的foreach循环名

$smarty->assign("arr_result", array(array("phone" => "1", "fax" => "2", "cell" => "3"),
array("phone" => "555-4444", "fax" => "555-3333", "cell" => "760-1234")));

<!!foreach name=outer item=contact from=$arr_result!!>
<!!foreach key=key item=item from=$contact!!>
<!!$key!!>: <!!$item!!>
<!!/foreach!!>
<!!/foreach!!>

<!!foreachelse!!> 在from变量没有值的时候被执行

下拉列表,html_options

输出下拉列表
> name         name of select group  
> values       an array of values for dropdown  
> output       an array of output for dropdown  
> selected     the selected option element(s)  
> options      an associative array of values and output 

<select name=customer_id>
    <!!html_options values=$cust_ids selected=$customer_id options=$cust_options output=$cust_names!!>
</select>

换行替换,nl2br

换行符替换成
<!!$articleTitle|nl2br!!>

默认值,default

当变量为空或者未分配的时候,将由给定的默认值替代输出. <!!$articleTitle|default:"no title"!!>

字符处理,capitalize,ucwords

将变量里的所有单词首字大写 <!!$articleTitle|capitalize!!> <!!$articleTitle|ucwords!!>

字符串连接,cat

字符串连接将cat里的值连接到给定的变量后面. <!!$articleTitle|cat:" yesterday."!!>

字符处理,strtolower

将变量里的所有单词小写. <!!$articleTitle|strtolower!!>

获取字符串,fetch

获取字符串 $str_html = $obj_smarty->fetch("index.html");

capture

capture函数的作用是收集模板输出的数据到一个变量里,而不是把它们输出到页面. 任何在 {capture name="foo"}和{/capture}之间的数据都被收到了由函数的名称属性指定的变量里($foo). 收集的信息可以用在特殊变量$smarty里. 例如capture.foo就收集了以上数据.如果函数没有名字属性,将使用"default". 每个{capture}都必须对应{/capture},也不能嵌套使用capture函数

{capture name=banner}
    1
{/capture}
{capture name=banner2}
    2
{/capture}

{if $smarty.capture.banner ne ""}
<tr>
    <td>
        {$smarty.capture.banner}
    </td>
    <td>
        {$smarty.capture.banner2}
    </td>
</tr>
{/if}

抓取数据存放在变量中可以在一个页面中重复使用

21:include_php,php

include_php 在模板里加载php文件,php可以直接使用php代码相当于<?php ?>

<!!include_php file="phpinfo.php"!!>
<!!php!!>
include("phpinfo.php");
echo date("h:i:s");
<!!/php!!>

insert

使模板的一部分不被缓存

//demo.php
$int_cache_id = sprintf('%X', crc32("index.html"));
if( !$obj_smarty->is_cached('index.html', $int_cache_id) ) {
    $obj_smarty->assign("str_date",date("h:i:s"));
}
$obj_smarty->display("index.html",$int_cache_id);

function insert_getBanner( $arrParams ) {
    return $arrParams["lid"]."-andy-".$arrParams["sid"];
}

//index.html
<!!$str_date!!>
<!!insert name="getBanner" lid="1" sid="2" !!>

ldelim,rdelim

ldelim and rdelim are used for displaying the literal delimiter, in our case "{" or "}". 输出变量不做解析

<!!ldelim!!>funcname<!!rdelim!!> is how functions look in Smarty!
OUTPUT:
<!!funcname!!> is how functions look in Smarty!

strip

去除<!!strip}<!!/strip!!>间的所有空格

{$smarty}保留变量

页面请求变量 { display value of page from URL (GET) http://www.domain.com/index.php?page=foo } {$smarty.get.page}

{ display the variable "page" from a form a form (POST) } {$smarty.post.page}

{ display the value of the cookie "username" } {$smarty.cookies.username}

{ display the server variable "SERVER_NAME" } {$smarty.server.SERVER_NAME}

{ display the system environment variable "PATH" } {$smarty.env.PATH}

{ display the php session variable "id" } {$smarty.session.id}

{ display the variable "username" from merged get/post/cookies/server/env } {$smarty.request.username}

{$smarty.now}变量用于访问当前时间戳.

可以用 date_format调节器格式化输出. { use the date_format modifier to show current date and time } {$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"}

{$smarty.const} 可以直接访问PHP常量. {$smarty.const._MY_CONST_VAL}

{$smarty.template} 当前被处理的模板的名字

组合使用调节器 |

<!!$articleTitle!!>
<!!$articleTitle|upper|spacify!!>
<!!$articleTitle|lower|spacify|truncate!!>
<!!$articleTitle|lower|truncate:30|spacify!!>
<!!$articleTitle|lower|spacify|truncate:30:". . ."!!>

fetch

抓取数据

{* include some javascript in your template *}
{fetch file="/export/httpd/www.domain.com/docs/navbar.js"}

{* embed some weather text in your template from another web site *}
{fetch file="http://www.myweather.com/68502/"}

{* fetch a news headline file via ftp *}
{fetch file="ftp://user:password@ftp.domain.com/path/to/currentheadlines.txt"}

{* assign the fetched contents to a template variable *}
{fetch file="http://www.myweather.com/68502/" assign="weather"}
{if $weather ne ""}
{$weather}
{/if}