openresty 中使用lua 的页面模板类库template来渲染页面

动态web网页开发是Web开发中一个常见的场景，比如像京东商品详情页，其页面逻辑是非常复杂的，需要使用模板技术来实现。而Lua中也有许多模板引擎，如目前我在使用的lua-resty-template，可以渲染很复杂的页面，借助LuaJIT其性能也是可以接受的。

如果学习过JavaEE中的servlet和JSP的话，应该知道JSP模板最终会被翻译成Servlet来执行；而lua-resty-template模板引擎可以认为是JSP，其最终会被翻译成Lua代码，然后通过ngx.print输出。

而lua-resty-template和大多数模板引擎是类似的，大体内容有：

模板位置：从哪里查找模板；

变量输出/转义：变量值输出；

代码片段：执行代码片段，完成如if/else、for等复杂逻辑，调用对象函数/方法；

注释：解释代码片段含义；

include：包含另一个模板片段；

其他：lua-resty-template还提供了不需要解析片段、简单布局、可复用的代码块、宏指令等支持。

模板的一些常用特殊指令，类似与jsp中的指令一样

{（include_file）}:包含另一个模板文件；

{* var *} ：变量输出；

{{ var }}：变量转义输出

{% code %}：代码片段

{# comment #}：代码注释

{-raw-}：中间内容不会解析，作为纯文本输出；

下载lua 模板类库

wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template.lua 

wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template/html.lua  

首先来看下template.lua的模板路径选择

lua查找模板页面路径的选择：以下是lua  template.lua的源码

两个指定的变量：

template_location:指向ngx的location，使用内部调用internal，alias用于指定文件夹的别名。

 注意：不能使用location =/templates 中的只 等于 ‘=’ 符号来修饰，因为lua脚本的源码 capture（location/file），比如/templates/t1.html，如果使用=匹配，就匹配不到了。

template_root：指向模板页面的根路径。

两者关系：首先从template_location中配置的路径获取模板，如果没有在从template_root配置的路径中获取，如果还是没有的话，最后从nginx的document_root中获取路径中的模板页面

 

API

使用模板引擎的目的就是输出响应内容：主要有两种方式输出：

第一种：通过ngx.print/ngx.say输出渲染后的内容。

第二种：得到模板渲染之后的内容按照想要的规则输出。

 

第一种配置：

模板的内容：

得到的结果：

第二种方式：

模板配置的内容：

结果如下：

模板最终被转换为lua代码进行执行，所以模板中可以执行任意的lua代码。