ThinkPhp 模板指南.txt 我是天使，回不去天堂是因为体重的原因别人装处，我只好装经验丰富泡妞就像挂 ，每天哄她 2 个小时，很快就可以太阳了模板指南ThinkPHP 内置了一个基于 XML 的性能卓越的模板引擎 ThinkTemplate，这是一个专门为ThinkPHP 服务的内置模板引擎ThinkTemplate 是一个使用了 XML 标签库技术的编译型模板引擎，支持两种类型的模板标签，使用了动态编译和缓存技术，而且支持自定义标签库其特点包括：2 支持 XML 标签库和普通标签的混合定义；2 支持直接使用 PHP 代码书写；2 支持文件包含和布局模板；2 支持多级标签嵌套；2 一次编译多次运行，编译和运行效率非常高；2 模板文件更新，自动更新模板缓存；2 系统变量无需赋值直接输出；2 支持多维数组的快速输出；2 支持模板变量的默认值；2 支持页面代码去除 Html 空白；2 支持变量组合调节器和格式化功能；2 允许定义模板禁用函数；2 通过标签库方式扩展每个模板文件在执行过程中都会生成一个编译后的缓存文件，其实就是一个可以运行的 PHP文件模板缓存默认位于项目的 Runtime/Cache 目录下面，以模板文件的 md5 编码作为缓存文件名保存的，如果开启页面 Trace 功能的话，可以在 Trace 信息里面看到当前页面对应的模板缓存文件名。
如果在模板标签的使用过程中发现问题，可以尝试通过查看模板缓存文件找到问题所在内置的模板引擎支持普通标签和 XML 标签方式两种标签定义，分别用于不同的目的：普通标签主要用于输出变量和做一些基本的操作；XML 标签除了包含了普通标签的所有功能外，还可以完成一些逻辑判断、控制和循环输出，但是在变量输出上，普通标签具有简洁明了的优势例如：{$name} 看起来比 更加容易使用，但是在控制和判断方面，XML 标签却有着普通标签无法替代的作用这种方式的结合保证了模板引擎的简洁和强大的有效融合变量输出我们已经知道了在 Action 中使用 assign 方法可以给模板变量赋值，赋值后怎么在模板文件中输出变量的值呢？如果我们在 Action 中赋值了一个 name 模板变量：$name = 'ThinkPHP';$this->assign('name',$name);使用内置的模板引擎输出变量，只需要在模版文件使用：{$name}模板编译后的结果就是最后运行的时候就可以在标签位置显示 ThinkPHP 的输出结果注意模板标签的{和$之间不能有任何的空格，否则标签无效普通标签默认开始标记是 {，结束标记是 }。
也可以通过设置 TMPL_L_DELIM 和TMPL_R_DELIM 进行更改例如，我们在项目配置文件中定义：'TMPL_L_DELIM'=>''}>',那么，上面的变量输出标签就应该改成：后面的内容我们都以默认的标签定义来说明assign 方法里面的第一个参数才是模板文件中使用的变量名称如果改成下面的代码：$name = 'ThinkPHP';$this->assign('name2',$name);再使用{$name} 输出就无效了，必须使用 {$name2} 才能输出模板变量的值了如果我们需要把一个用户数据对象赋值给模板变量：$User = M('name');$user = $User->find(1);$this->assign('user',$user);也就是说$user 其实是一个数组变量，我们可以使用下面的方式来输出相关的值：{$user['name']} // 输出用户的名称{$user['email']} // 输出用户的 email 地址如果$user 是一个对象而不是数组的话，$User = M('name');$User->find(1);$this->assign('user',$User);可以使用下面的方式输出相关的属性值：{$user:name} // 输出用户的名称{$user:email} // 输出用户的 email 地址为了方便模板定义，还可以支持点语法，例如，上面的{$user['name']} // 输出用户的名称{$user['email']} // 输出用户的 email 地址可以改成{$user.name}{$user.email}因为点语法默认的输出是数组方式，所以上面两种方式是在没有配置的情况下是等效的。
我们可以通过配置 TMPL_VAR_IDENTIFY 参数来决定点语法的输出效果，以下面的输出为例：{$user.name}如果 TMPL_VAR_IDENTIFY 设置为 array，那么{$user.name}和{$user['name']}等效，也就是输出数组变量如果 TMPL_VAR_IDENTIFY 设置为 obj，那么{$user.name}和{$user:name}等效，也就是输出对象的属性如果 TMPL_VAR_IDENTIFY 留空的话，系统会自动判断要输出的变量是数组还是对象，这种方式会一定程度上影响效率，而且只支持二维数组和两级对象属性如果是多维数组或者多层对象属性的输出，可以使用下面的定义方式：{$user.sub.name} // 使用点语法输出或者使用{$user['sub']['name']} // 输出三维数组的值{$user:sub:name} // 输出对象的多级属性使用函数仅仅是输出变量并不能满足模板输出的需要，内置模板引擎支持对模板变量使用调节器和格式化功能，其实也就是提供函数支持，并支持多个函数同时使用用于模板标签的函数可以是 PHP 内置函数或者是用户自定义函数，和 smarty 不同，用于模板的函数不需要特别的定义。
模板变量的函数调用格式为：{$varname|function1|function2=arg1,arg2,### } 说明： { 和 $ 符号之间不能有空格 ，后面参数的空格就没有问题###表示模板变量本身的参数位置 支持多个函数，函数之间支持空格 支持函数屏蔽功能，在配置文件中可以配置禁止使用的函数列表 支持变量缓存功能，重复变量字串不多次解析使用例子：{$webTitle|md5|strtoupper|substr=0,3}编译后的 PHP 代码就是：注意函数的定义和使用顺序的对应关系，通常来说函数的第一个参数就是前面的变量或者前一个函数使用的结果，如果你的变量并不是函数的第一个参数，需要使用定位符号，例如：{$create_time|date="y-m-d",###}编译后的 PHP 是：函数的使用没有个数限制，但是可以允许配置 TMPL_DENY_FUNC_LIST 定义禁用函数列表，系统默认禁用了 exit 和 echo 函数，以防止破坏模板输出，我们也可以增加额外的定义，例如：TMPL_DENY_FUNC_LIST=>"echo,exit,halt"多个函数之间使用半角逗号分隔即可。
并且还提供了在模板文件中直接调用函数的快捷方法，无需通过模板变量，包括两种方式：1、执行方法并输出返回值：格式：{:function(…)} 例如，输出 U 方法的返回值：{:U('User/insert')}编译后的 PHP 代码是2、执行方法但不输出：格式：{~function(…)} 例如，调用 say_hello 函数：{~say_hello('ThinkPHP')}编译后的 PHP 代码是：系统变量除了常规变量的输出外，模板引擎还支持系统变量和系统常量、以及系统特殊变量的输出它们的输出不需要事先赋值给某个模板变量系统变量的输出必须以$Think. 打头，并且仍然可以支持使用函数1、系统变量：包括 server、session、post、get、request、cookie{$Think.server.script_name } // 输出$_SERVER 变量{$Think.session.session_id|md5 } // 输出$_SESSION 变量{$Think.get.pageNumber } // 输出$_GET 变量{$Think.cookie.name } // 输出$_COOKIE 变量支持输出$_SERVER、$_ENV、 $_POST、 $_GET、 $_REQUEST、$_SESSION 和 $_COOKIE 变量。
后面的 server、cookie、config 不区分大小写，但是变量区分大小写例如：{$Think.server.script_name }和{$Think.SERVER.script_name }等效SESSION 、COOKIE 还支持二维数组的输出，例如：{$Think.CONFIG.user.user_name}{$Think.session.user.user_name}系统不支持三维以上的数组输出，请使用下面的方式输出以上方式还可以写成：{$_SERVER.script_name } // 输出$_SERVER 变量{$_SESSION.session_id|md5 } // 输出$_SESSION 变量{$_GET.pageNumber } // 输出$_GET 变量{$_COOKIE.name } // 输出$_COOKIE 变量2、系统常量 ：使用$Think.const 输出{$Think.const.__SELF__ } {$Think.const.MODULE_NAME }或者直接使用{$Think.__SELF__ } {$Think.MODULE_NAME }3、特殊变量 ：由 ThinkPHP 系统内部定义的常量{$Think.version } //版本 {$Think.now } //现在时间 {$Think.template|basename } //模板页面 {$Think.LDELIM } //模板标签起始符号 {$Think.RDELIM } //模板标签结束符号4、配置参数 ：输出项目的配置参数值{$Think.config.db_charset}输出的值和 C('db_charset') 的返回结果是一样的。
也可以输出二维的配置参数，例如：{$Think.config.user.user_name}5、语言变量：输出项目的当前语言定义值{$Think.lang.page_error}输出的值和 L('page_error')的返回结果是一样的快捷输出为了使得模板定义更加简洁，系统还支持一些常用的变量输出快捷标签，包括：{@var} //输出 Session 变量 和 {$Think.session.var} 等效{#var} //输出 Cookie 变量 和 {$Think.cookie.var} 等效{&var} //输出配置参数 和 {$Think.config.var} 等效{%var} //输出语言变量 和 {$Think.lang.var} 等效{.var} //输出 GET 变量 和 {$Think.get.var} 等效{^var} //输出 POST 变量 和{$Think.post.var} 等效{*var} //输出常量和 {$Think.const.var} 等效如果需要输出二维数组，例如 要输出$_SESSION[‘var1’][‘var2’]的值 快捷输出可以使用：{@var1.var2} 的方式同理 {#var1.var2} 可以输出 $_COOKIE[‘var1’][‘var2’]的值。
必须注意的是：快捷输出的变量不支持函数的使用所以，下面的用法是错误的：{#var|strlen}默认值输出如果输出的模板变量没有值，但是我们需要在显示的时候赋予一个默认值的话，可以使用default 语法，格式：{$变量|default="默认值"}这里的 default 不是。