Smarty中文手册.docx

什么是SmartySmarty是一个使用PHP写出来的模板引擎，是目前业界最著名的PHP模板引擎之一。它分离了逻辑代码和外在的内容，提供了一种易于管理和使用的方法，用来将原本与HTML代码混杂在一起PHP代码逻辑分离。简单的讲，目的就是要使PHP程序员同前端人员分离，使程序员改变程序的逻辑内容不会影响到前端人员的页面设计，前端人员重新修改页面不会影响到程序的程序逻辑，这在多人合作的项目中显的尤为重要。Smarty下载/Smarty目录配置模板目录通常名称为tpl/，在smarty成员$Smarty-template_dir定义。模板编译目录通常名称为tpl_c/，在smarty成员$Smarty-compile_dir定义。Smarty配置目录通常名称为inc/smarty/，在smarty成员$Smarty-config_dir定义。Smarty cache目录通常名称为cache/，在smarty成员$Smarty-cache_dir定义。Smarty的基本格式smartytest.phploadTpl(); / new Smarty$smarty-left_delimiter = right_delimiter = ; / 规定模板右标签$smarty-assign(test_smarty, Hello Smarty); / 模板赋值$smarty-display(smartytest/SimpleExample1.html); / 抛出页面SimpleExample1.html Smarty的条件判断简单的条件判断结构onetwothreeSmarty条件运算符列举如下：eq相等，ne、neq不相等，gt大于，lt小于，gte、ge大于等于，lte、le 小于等于，not非， mod求模。is not div by是否能被某数整除，is not even是否为偶数，$a is not even by $b即($a / $b) % 2 = 0，is not odd是否为奇，$a is not odd by $b即($a / $b) % 2 != 0 Smarty的循环foreach一维数组SimpleExample2二维数组SimpleExample3foreach属性表Attribute Name属性名称Type类型Required必要Default默认值Description描述fromarray数组Yes必要n/aThe array you are looping through循环访问的数组itemstring字符串Yes必要n/aThe name of the variable that is the current element当前元素的变量名keystring字符串No可选n/aThe name of the variable that is the current key当前键名的变量名namestring字符串No可选n/aThe name of the foreach loop for accessing foreach properties用于访问foreach属性的foreach循环的名称 from和item是必要属性 foreach循环的name可以是任何字母，数组，下划线的组合，参考PHP变量。 foreach循环可以嵌套，嵌套的foreach的名称应当互不相同。 from属性通常是值数组，被用于判断foreach的循环次数。 在from变量中没有值时，将执行foreachelse。 foreach循环也有自身属性的变量，可以通过$perty访问，其中name是name属性。注意：name属性仅在需要访问foreach属性时有效，与section不同。访问未定义name的foreach属性不会抛出一个错误，但将导致不可预知的结果。foreach 变量index:包含当前数组索引，从零开始。iteration: 包含当前循环次数，与index不同，从1开始，每次循环增长1。first: 在当前foreach循环处于初始位置时值为TRUE。last: 在当前foreach循环处于最终位置是值为TRUE。show: 是 foreach 的参数. show 取值为布尔值 true 或 false. 如果设置为 false，该循环将不显示. 如果指定了 foreachelse 子句，该字句是否显示也取决于该值.total: 用于显示循环执行总的次数. 可以在循环中或执行结束后调用此属性.section一维数组正例：SimpleExample6反例：SimpleExample7二维数组SimpleExample5section属性表Attribute Name属性名称Type类型Required必要Default默认值Description描述namestring字符串Yes必要n/aThe name of the section loop该循环的名字looparray数组Yes必要n/aThe array you are looping through循环访问的数组startInteger整形No可选n/a循环执行的初始位置. 如果该值为负数，开始位置从数组的尾部算起. 例如：如果数组中有 7 个元素，指定start 为-2，那么指向当前数组的索引为 5. 非法值(超过了循环数组的下限) 将被自动调整为最接近的合法值.stepInteger整形No可选n/a该值决定循环的步长. 例如指定 step=2 将只遍历下标为 0、2、4 等的元素. 如果step 为负值，那么遍历数组的时候从后向前遍历.maxInteger整形No可选n/a设定循环最大执行次数showBoolean布尔No可选n/a决定是否显示该循环section变量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:用于显示该循环上一次循环时的索引值. 该值