【PHP 模板引擎】Prototype 原型版发布！

Template :: $rootPath = dirname(__FILE__); // 相对与绝对路径均可，我们这里则采用绝对路径！如："C:/wwwroot/prototype"

// 这里则采用默认目录，大家根据自己的需求进行设置，建议不要写中文容易出错，目录名的前后加不加正反斜杠都无所谓，最终模板引擎内部会自动校正！
Template :: $templateName = ‘/templates/‘;

Template :: $compileName = ‘/compiles/‘; // 和模板目录一样也采用默认目录。

Template :: $cacheName = ‘/caches/‘; // 一样使用默认

Template :: $constantName = ‘/constants/‘; // 使用默认

// 我们也采用默认，但大家要注意的是这里必须采用 .xml 为扩展名，因为常量文件是以 XML 标记描述的，如果不是 .xml 结尾，那么可能会导致模板引擎在处理常量时出现异常情况！
Template :: $constantFile = ‘default.xml‘;

// 大家注意，这里我写的是一个布尔值，其实这里可以填写任意值，最终都会被隐式转换为布尔值，写 0 或 1 都可以，我直接写布尔值是为了方便大家的理解！
Template :: $cacheSwitch = true;

$tpl = new Template(); // 实例化出模板引擎，从这一步开始之前的配置全部生效，模板引擎实例化时不需要传递任何参数。

// 注入变量的格式有两种，大家注意看 API 手册的说明，数组格式与传统的键值对格式均可以，我们两种都使用一下。
$tpl -> assign(‘title‘, ‘头衔‘); // 首先是传统键值对格式

$tpl -> assign(array(‘title‘ => ‘头衔‘, ‘name‘ => ‘名称‘)); // 数组格式明显要更加好用一些，因为在注入多个变量时，就可以不用写多个注入语句，一句话就搞定了。

// 如果出现了两个一模一样的变量名称，那么其后会将之前的给替换掉。以下代码，最终 language 变量的值为：英文。
$tpl -> assign(array(‘language‘ => ‘中文‘, ‘language‘ => ‘英文‘));

// 接下来是加载模板文件，直接写模板名称即可，模板引擎会自动锁定到模板文件目录。
$tpl -> display(‘index.tpl‘);

<div id="main">
    <!-- 刚刚我们注入了 title 变量，那么模板在模板文件中就可以对其进行调用了，调用方法就是保持同名，按着这样的格式抒写即可{$模板变量名称}-->
    <!-- 模板变量的命名规范与 PHP 普通变量一模一样，首位不能为数字，且区分大小写，注意保证格式的正确性，如果错误模板引擎将不会对其进行解析 -->
    <a href="###">{$title}</a> <!-- 正确的格式，被正确解析 -->
    <a href="###">{$123}</a> <!-- 错误的格式，无法解析 -->
</div>

<?xml version="1.0" coding="utf-8" ?>
<root>
    <!-- 必须在 root 根标记中间进行添加，而且一个标记字母都不能出错，注意区分大小写，如果不慎写错，模板引擎将无法对其进行获取 -->
    <constant>
        <key>WEBNAME</key> <!-- 这里填写常量名称注意字母必须全部大写，第一位不能为数字，格式与 PHP 定义常量一样 -->
        <value>网站标题</value> <!-- 值可以为空 -->
    </constant>
    
    <constant>
        <key>123abc</key> <!-- 错误的常量名 -->
        <value></value> <!-- 空值 -->
    </constant>
</root>

<!-- 模板常量的调用和变量类似，只是取消了 $ 符号，另外常量名要保持一致 -->
<title>{WEBANME}</title> <!-- 正确的名称，将被正确解析 -->
<p>{NAME}</p> <!-- 虽然格式正确，但刚才没有进行 NAME 常量的配置，因此最终解析后会返回一个空值 -->
<p>{abc123}</p> <!-- 错误的名称，无法解析 -->

<!-- 大家可以把模板注释放到 HTML 注释中，这样美工在设置模板页面的时候会更加一目了然。-->
<!-- 单行注释的格式是：{@}内容可写可不写，但不写也就没有意义了 -->
{@ 普通的单行注释} <!-- 正确的格式 -->
<!-- {@ HTML 代码中的单行注释} --> <!-- 正确的格式 -->
{@ 换行的
单行注释} <!-- 格式错误，单行注释无法换行，模板引擎无法解析 -->

<!-- 多行注释的格式是：{#}...{/#}一头一尾要呼应，内容也可以不写 -->
{#}这是多行行注释，注意首位呼应！{/#} <!-- 正确的格式 -->
{#}这是多行行注释，
我换行了！{/#} <!-- 正确的格式 -->
{#} 没有写结尾符号 <!-- 错误的格式，模板引擎无法解析 -->

<!-- 注意抒写格式，被直接加载的文件多半是 php 文件，且文件必须要存在，不存在的文件，模板引擎将会给出一个错误提示，并且终止代码的执行 -->
<!-- 文件名前后的引号，单双引号都可以，但必须保持一致，不能一单一双，否则模板引擎将不会对其解析 -->
{include path = "test.php"} <!-- 正确的格式，将被解析 -->
{include path = ‘abc.php"} <!-- 错误的格式，无法被解析 -->
<!-- 如果出现了同一个文件被加载了两次，那么模板引擎只会对其加载第一次后，自动忽略其后的加载 -->
{include path = "123.php"} <!-- 第一次被加载成功 -->
{include path = "123.php"} <!-- 与上一个文件同属一个文件，将无法被再次加载，而被自动忽略 -->

<!-- 格式与 include 方式基本一样，就不重复阐述了，不一样的是 include 是需要给出具体的路径地址，而 template 则只需要给出模板名称即可，模板引擎会自动找到该模板文件 -->
{template path = ‘test.tpl‘} <!-- 正确的格式，将会被编译后加载 -->

<!-- 这里我们将使用 iframe 框架页面，来调用 source 加载方法，调用格式与前两种雷同，就不在阐述 -->
<!-- 这样使用其实就可以了，但又严重的 BUG 出现，原因是所有在 frame.tpl 中注入的模板标记被解析后，将无法找到源头，也就是说 php 将无法对其正确处理，并且因为无法找到源头，而会报错，该 BUG 的解决方案还在研究中，这里仅提供给大家思考 -->
<iframe src="{source path = ‘frame.tpl‘}"></iframe>

<!-- if 语句的格式其实和多行注释一样，一定要注意首位呼应，但大小写无所谓都能够支持和 PHP 原生的 if 语句是一样的。 -->
{if $action} <!-- 只要被注入的 {$action} 变量的值为 true，或隐式转换后为 true，那么 if 语句中的代码将被显示 -->
<p>界面1</p>
{/if}

{if !$action} <!-- 加入了逻辑非的判断，只要为 false 则被显示 -->
<p>界面2</p>
{/if}

{if $action} <!-- 双层判断的时候，为 true 时显示界面1，为 false 时显示界面2 -->
<p>界面1</p>
{else}
<p>界面2</p>
{/if}

{if $action} <!-- 错误的格式，没有结尾，不会被模板引擎解析 -->

<!-- 注意在调用 foreach 和 if 一样要收尾呼应，而且如果变量不是数组格式，那么 php 将会自动报出一个错误 -->
<!-- 其中 $array 就是被注入的模板变量，注意要是数组格式；而 key 和 value 则是对于的数组中的键值对，必须写，否则格式不正确，将无法被模板引擎解析 -->
{foreach $array(key, value)}
    <p>{%key} ... {%value}</p> <!-- 注意 key 和 value 可以自定义，但一定要同名调用，否则无法被解析 -->
{/foreach}

{foreach $userList(id, username)}
   <p>{%id} ... {%username}</p> <!-- 自定义的 key 和 value，格式正确 -->
    <p>{%password}</p> <!-- 错误的格式，并没有被定义，因此无法被解析 -->
{/foreach}