1 Basic Syntax

Smarty的标签都是使用定界符括起来。 默认定界符是{}, 但定界符可以被改变

注释
{* 这是一个注释 *}

变量
模板变量以美元符号$开头,由字母、数组和下划线组成,和 PHP variable相似。 变量可以引用数字索引或非数字索引的数组,对象的属性和方法等。
举例:

{$foo}        <-- 显示简单的变量 (非数组/对象)
{$foo[4]}     <-- 在0开始索引的数组中显示第五个元素
{$foo.bar}    <-- 显示"bar"下标指向的数组值,等同于PHP的$foo['bar']
{$foo.$bar}   <-- 显示以变量$bar值作为下标指向的数组值,等同于PHP的$foo[$bar]
{$foo->bar}   <-- 显示对象属性 "bar"
{$foo->bar()} <-- 显示对象成员方法"bar"的返回
{#foo#}       <-- 显示变量配置文件内的变量"foo"
{$smarty.config.foo} <-- 等同于{#foo#}
{$foo[bar]}   <-- 仅在循环的语法内可用,见{section}
{assign var=foo value='baa'}{$foo} <--  显示"baa", 见{assign}```

**配置变量**
[配置变量](http://www.smarty.net/docs/zh_CN/language.config.variables.tpl) 是例外的,它不是以美元符号$开头,而是放到两个井号中间```#hashmarks#```, 或者通过```$smarty.config```来使用。

**函数**
每个Smarty的标签都可以是显示一个变量或者调用某种类型的函数。调用和显示的方式是在定界符内包含了函数,和其属性, 如:```{funcname attr1="val1" attr2="val2"}```

- 包括[内置函数](http://www.smarty.net/docs/zh_CN/language.builtin.functions.tpl) 和[自定义函数](http://www.smarty.net/docs/zh_CN/language.custom.functions.tpl) 都是用同样的语法调用。
- 内置函数是工作在Smarty**内部**的函数, 类似 [{if}
](http://www.smarty.net/docs/zh_CN/language.function.if.tpl), [{section}
](http://www.smarty.net/docs/zh_CN/language.function.section.tpl)和 [{strip}
](http://www.smarty.net/docs/zh_CN/language.function.strip.tpl)等等。 它们不需要进行修改或者改变。
- 自定义函数是通过[插件](http://www.smarty.net/docs/zh_CN/plugins.tpl)定义的**额外的**函数。 你可以任意修改自定义函数,或者创建一个新的函数。 [{html_options}
](http://www.smarty.net/docs/zh_CN/language.function.html.options.tpl)就是一个自定义函数的例子。


**属性**
大多数函数都会使用属性来定义或者修改它们的行为。

Smarty函数中的属性比较像HTML语法中的属性。静态值不需要引号引起来,但必须是纯字符串。带或不带修饰器的变量都可以使用,而且也不需要引号, 甚至可以使用PHP函数的结果,插件结果和复杂的表达式。
一些属性要求布尔值(TRUE或 FALSE)。 它们可以直接写成```true```和```false```。如果属性没有被赋值,那么它会将true作为默认值。
举例:

{include file="header.tpl" attrib_name="attrib value"}
{assign var=foo value={counter}} // 插件结果
{assign var=foo value=substr($bar,2,5)} // PHP函数结果
{assign var=foo value=$bar|strlen} // 使用修饰器
{assign var=foo value=$buh+$bar|strlen} // 复杂的表达式
{html_select_date display_days=true}说明:{assign}用于在模板运行期间赋值给变量。var-被赋值的变量名,value-赋的值,scope-变量的作用范围:'parent','root' 或 'global'```

双引号中嵌入变量

  • Smarty可以识别出在双引号中嵌套的 变量值 --> 这些变量名称必须包括 字母、数字和下划线。比如:
    {func var="test $foo_bar test"} // 识别变量 $foo_bar
  • 如果该变量带有其他字符的,如点号(.)或者 $object->reference形式的, 必须用单引号括起来。比如:
    {func var="test `$foo.bar` test"} // 识别变量 $foo.bar
  • Smarty3中允许在双引号中嵌入Smarty的标签并运行。比如:
    {func var="test {time()} test"} // PHP函数结果

数学计算
变量值内可以直接进行数学计算。比如:

{$foo*$bar}
{$foo->bar-$bar[1]*$baz->foo->bar()-3*7}```


**避免Smarty解析**
有时候部分模板中的代码是不需要或者不希望被Smarty解析的, 比较典型的例子是嵌入在页面HTML中的Javascript或CSS代码。 但这些语言会经常使用{ 和 },也恰好是Smarty的定界符。

- 解决方法一:避免被解析的一个好方法,是将Javascript/CSS代码分离到单独的文件中, 然后在HTML中引入它们。而且这样也有利于浏览器进行缓存。 
- 解决方法二:Smarty模板中,当{ 和 }定界符两边都是空格的时候,将会被自动忽略解析。
- 解决方法三:```{literal}..{/literal}```可以让块中间的内容忽略Smarty的解析。在需要使用定界符的时候,可以通过```{ldelim}...{rdelim}```标签,或者```{$smarty.ldelim}...{$smarty.rdelim}```的变量来使用。
- 解决方法四:自定义 定界符。通过修改Smarty的```$left_delimiter```和```$right_delimiter```的变量值,设置更适合的定界符。比如:

$smarty->left_delimiter = '';
?>```


  var foo = ;

{debug}
我们可以使用smaty的{debug}来调试代码,YOUTUBE教程

你可能感兴趣的:(1 Basic Syntax)