ThinkPHP 模板魔术常量

2019独角兽企业重金招聘Python工程师标准>>>

模板特殊字符串替换

ThinkPHP 系统定义了一些特殊的字符串（常量）以方便在模板中的使用，这些特殊字符串给模板的应用带来了极大的便利。

这些特殊的字符串是在进行模板输出之前有系统自动替换的，默认的模板特殊字符串如下：

• ../Public：当前项目的公共模板目录，通常是 /项目目录/Tpl/default/Public/
• __PUBLIC__：当前网站的公共目录，通常是 /Public/
• __TMPL__：项目的模板目录，通常是 /项目目录/Tpl/default/
• __ROOT__：当前网站的地址（不含域名）
• __APP__：当前项目的 URL 地址（不含域名）
• __URL__：当前模块的 URL 地址（不含域名）
• __ACTION__：当前操作的 URL 地址（不含域名）
• __SELF__：当前的页面 URL

假定我们的网站为：www.5idev.com

定义项目文件为网站根目录下 Home 目录

当前模块为：Index

当前操作为：index

当前页面 URL 则为：http://www.5idev.com/index.php/Index/index

那么上述特殊字符在 index.html 模板中被解释为：

• ../Public：/Home/Tpl/default/Public/
• __PUBLIC__：/Public/
• __TMPL__：/Home/Tpl/default/
• __ROOT__：网站根目录
• __APP__：/index.php
• __URL__：/index.php/Index
• __ACTION__：/index.php/Index/index
• __SELF__：/index.php/Index/index（页面实际地址）

模板替换补充说明

__PUBLIC__：会定位于 DOCUMENT_ROOT 级别的根目录下。

__ROOT__：则与项目入口文件有关，不一定定位于 DOCUMENT_ROOT 下。

__ACTION__：行为类似于 $_SERVER['REQUEST_URI'] ，当改写了访问 URL 时（如利用 .htaccess 文件），其结果与 __SELF__ 不一致。

__SELF__：行为类似于 $_SERVER['PHP_SELF'] ，通常是实际页面地址。

以上特殊字符严格区分大小写，在实际应用中最好根据自己的项目部署情况经过具体测试后使用，以免产生不可预知的问题。

例子1，首页链接：

<a href="__ROOT__/" title="Web开发在线教程">首页</a>

例子2，加载公共目录 CSS 文件：

<load href='__PUBLIC__/Css/default.css' />

例子3，提交表单数据：

<form action="__URL__/insert" method="post">

自定义特殊替换字串

ThinkPHP 支持用户更改默认的替换规则甚至定义自己的模板替换特殊字符串。在项目配置文件中配置 TMPL_PARSE_STRING 选项以更改或增加模板替换字符串，如：

TMPL_PARSE_STRING  => array(
    '__PUBLIC__' => '/Common',            // 更改默认的 __PUBLIC__ 替换规则
    '__UPLOAD__' => '/Public/Uploads/',    // 增加新的上传路径替换规则
)

参考阅读

ThinkPHP 系统配置

转载于:https://my.oschina.net/wxweven/blog/56987