模版渲染

动态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还提供了不需要解析片段、简单布局、可复用的代码块、宏指令等支持。

下载lua-resty-template

wget https://github.com/bungle/lua-resty-template/archive/v1.9.tar.gz

tar -xvzf v1.9.tar.gz

解压后可以看到lib/resty下面有一个template.lua，这个就是我们所需要的，在template目录中还有两个lua文件，将这两个文件复制到/usr/openResty/lualib/resty中即可。

接下来就可以通过如下代码片段引用了：

local template = require("resty.template")

模版位置

我们需要告诉lua-resty-template去哪儿加载我们的模块，此处可以通过set指令定义template_location、template_root或者从root指令定义的位置加载。

我们可以在openResty.conf配置文件的server部分定义

# first match ngx location

set $template_location "/templates";

# then match root read file

set $template_root "/usr/openResty/templates";

也可以通过在server部分定义root指令

root /usr/openResty/templates;

其顺序是

local function load_ngx(path)

    local file, location = path, ngx_var.template_location

    if file:sub(1)  == "/" then file = file:sub(2) end

    if location and location ~= "" then

        if location:sub(-1) == "/" then location = location:sub(1, -2) end

        local res = ngx_capture(location .. '/' .. file)

        if res.status == 200 then return res.body end

    end

    local root = ngx_var.template_root or ngx_var.document_root

    if root:sub(-1) == "/" then root = root:sub(1, -2) end

    return read_file(root .. "/" .. file) or path

end
  1. 通过ngx.location.capture从template_location查找，如果找到（状态为为200）则使用该内容作为模板；此种方式是一种动态获取模板方式；
  2. 如果定义了template_root，则从该位置通过读取文件的方式加载模板；
  3. 如果没有定义template_root，则默认从root指令定义的document_root处加载模板。



    此处建议首先template_root，如果实在有问题再使用template_location，尽量不要通过root指令定义的document_root加载，因为其本身的含义不是给本模板引擎使用的。



    接下来定义模板位置
mkdir /usr/openResty/templates

mkdir /usr/openResty/templates2

openResty.conf配置文件

# first match ngx location

set $template_location "/templates";

# then match root read file

set $template_root "/usr/openResty/templates";

location /templates {

    internal;

    alias /usr/openResty/templates2;

}

首先查找/usr/openResty/template2，找不到会查找/usr/openResty/templates。

然后创建两个模板文件

vi /usr/openResty/templates2/t1.html

内容为

template2


vi /usr/example/templates/t1.html

内容为

 template1

test_temlate_1.lua

local template = require("resty.template")

template.render("t1.html")

openResty.conf配置文件

location /lua_template_1 {

    default_type 'text/html';

    lua_code_cache on;

    content_by_lua_file /usr/openResty/lua/test_template_1.lua;

}

访问如http://127.0.0.1/lua_template_1将看到template2输出。然后rm /usr/openResty/templates2/t1.html，reload nginx将看到template1输出。

接下来的测试我们会把模板文件都放到/usr/openResty/templates下。

API

使用模板引擎目的就是输出响应内容；主要用法两种：直接通过ngx.print输出或者得到模板渲染之后的内容按照想要的规则输出。

test_template_2.lua

local template = require("resty.template")

--是否缓存解析后的模板，默认true

template.caching(true)

--渲染模板需要的上下文(数据)

local context = {title = "title"}

--渲染模板

template.render("t1.html", context)

ngx.say("<br/>")

--编译得到一个lua函数

local func = template.compile("t1.html")

--执行函数，得到渲染之后的内容

local content = func(context)

--通过ngx API输出

ngx.say(content)

常见用法即如下两种方式：要么直接将模板内容直接作为响应输出，要么得到渲染后的内容然后按照想要的规则输出。

openResty.conf配置文件

location /lua_template_2 {

    default_type 'text/html';

    lua_code_cache on;

    content_by_lua_file /usr/openResty/lua/test_template_2.lua;

}

使用示例

test_template_3.lua

local template = require("resty.template")

local context = {

  title = "测试",

  name = "张三",

  description = "<script>alert(1);</script>",

  age = 20,

  hobby = {"电影", "音乐", "阅读"},

  score = {语文 = 90, 数学 = 80, 英语 = 70},

  score2 = {

    {name = "语文", score = 90},

    {name = "数学", score = 80},

    {name = "英语", score = 70},

  }

}

template.render("t3.html", context)

模板文件/usr/openResty/templates/t3.html

<html>

  <head>

    <meta charset="UTF-8" />

  </head>

  <body>

    {# 不转义变量输出 #}

    姓名：{* string.upper(name) *}<br/>

    {# 转义变量输出 #}

    简介：{{description}}<br/>

    {# 可以做一些运算 #}

    年龄: {* age + 1 *}<br/>

    {# 循环输出 #}

    爱好：

    {% for i, v in ipairs(hobby) do %}

      {% if i > 1 then %}，{% end %}

      {* v *}

    {% end %}<br/>

    成绩：

    {% local i = 1; %}

    {% for k, v in pairs(score) do %}

      {% if i > 1 then %}，{% end %}

      {* k *} = {* v *}

      {% i = i + 1 %}

    {% end %}<br/>

    成绩2：

    {% for i = 1, #score2 do local t = score2[i] %}

      {% if i > 1 then %}，{% end %}

      {* t.name *} = {* t.score *}

    {% end %}<br/>

    {# 中间内容不解析 #}

    {-raw-}{(file)}{-raw-}

  </body>

</html>

{(include_file)}：包含另一个模板文件；

{* var *}：变量输出；

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

{% code %}：代码片段；

{# comment #}：注释；

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

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

openResty.conf配置文件

location /lua_template_3 {

    default_type 'text/html';

    lua_code_cache on;

    content_by_lua_file /usr/openResty/lua/test_template_3.lua;

}

访问如http://127.0.0.1/lua_template_3进行测试。

基本的模板引擎使用到此就介绍完了。

高并发 Nginx+Lua OpenResty系列（8）——Lua模版渲染的更多相关文章

  1. 高并发 Nginx+Lua OpenResty系列（11）——流量复制/AB测试/协程

    流量复制 在实际开发中经常涉及到项目的升级,而该升级不能简单的上线就完事了,需要验证该升级是否兼容老的上线,因此可能需要并行运行两个项目一段时间进行数据比对和校验,待没问题后再进行上线.这其实就需要进 ...

  2. 高并发 Nginx+Lua OpenResty系列（4）——Lua 模块开发

    在实际开发中,不可能把所有代码写到一个大而全的lua文件中,需要进行分模块开发:而且模块化是高性能Lua应用的关键.使用require第一次导入模块后,所有Nginx 进程全局共享模块的数据和代码,每 ...

  3. 高并发 Nginx+Lua OpenResty系列（2）——Nginx Lua API

    Nginx Lua API 和一般的Web Server类似,我们需要接收请求.处理并输出响应.而对于请求我们需要获取如请求参数.请求头.Body体等信息:而对于处理就是调用相应的Lua代码即可:输出 ...

  4. 高并发 Nginx+Lua OpenResty系列（1）——环境搭建

    OpenResty是一款基于Nginx的高性能负载均衡服务器容器,简单来说是Nginx+Lua.结合了Lua语言来对Nginx进行扩展,使得在Nginx上具有web容器功能. OpenResty运行环 ...

  5. 高并发 Nginx+Lua OpenResty系列（7）——Lua开发库json

    JSON库 在进行数据传输时JSON格式目前应用广泛,因此从Lua对象与JSON字符串之间相互转换是一个非常常见的功能:目前Lua也有几个JSON库,如:cjson.dkjson.其中cjson的语法 ...

  6. 高并发 Nginx+Lua OpenResty系列（10）——商品详情页

    本章以京东商品详情页为例,京东商品详情页虽然仅是单个页面,但是其数据聚合源是非常多的,除了一些实时性要求比较高的如价格.库存.服务支持等通过AJAX异步加载加载之外,其他的数据都是在后端做数据聚合然后 ...

  7. 高并发 Nginx+Lua OpenResty系列（9）——HTTP服务

    此处我说的HTTP服务主要指如访问京东网站时我们看到的热门搜索.用户登录.实时价格.实时库存.服务支持.广告语等这种非Web页面,而是在Web页面中异步加载的相关数据.这些服务有个特点即访问量巨大.逻 ...

  8. 高并发 Nginx+Lua OpenResty系列（5）——Lua开发库Redis

    Redis客户端 lua-resty-redis是为基于cosocket API的ngx_lua提供的Lua redis客户端,通过它可以完成Redis的操作.默认安装OpenResty时已经自带了该 ...

  9. 高并发 Nginx+Lua OpenResty系列（3）——模块指令

    Nginx Lua 模块指令 Nginx共11个处理阶段,而相应的处理阶段是可以做插入式处理,即可插拔式架构:另外指令可以在http.server.server if.location.locatio ...

随机推荐

  1. MyEclipse和Eclipse区别与联系

    Eclipse:IBM花了4千万美金来开发这个IDE(Integrated Development Environment).第一版1.0在2001年11月释出,随后逐渐受到欢迎.Eclipse已经成 ...

  2. JAVA学习第三十三课（经常使用对象API） —迭代器

    数字有非常多用数组存,对象有非常多就要用集合存 可是数组是固定长度的,集合是可变长度的 集合的由来: 对象用来封装特有数据,对象多了须要存储,假设对象个数不确定,就须要使用集合容器来存储 集合的特点: ...

  3. Cocos2d-x3.1颗粒使用

    1.头 #include "cocos2d.h" USING_NS_CC; class WaterWaveDemo : public Layer { public: static ...

  4. python两个整数和浮点的方法来获取值

    /*********************************************************************  * Author  : Samson  * Date   ...

  5. qt线程（转）----这篇很专业！

    本文档是自己所整理的一份文档,部分是原创,还转贴了网上的一此资料(已经标明了),(难点是多线程的编写),是有源代码的,大家可以作为参考,用到的知识是视频采集,压缩解压(xvid),实时传输(jrtp) ...

  6. Entity framework 更改模型，新增表

    在Package Manager Console 中运行命令Enable-Migrations 再次运行可以更新 抄袭 在实体类中增加一个属性以后,执行 Update-Database 命令 ,可以更 ...

  7. C#实现下载的几种方式举例

    using System; using System.Data; using System.Configuration; using System.Web; using System.Web.Secu ...

  8. XAML的命名空间

    原文:XAML的命名空间 一个最简单的XAML例子   <Window x:Class="WpfApplication1.MainWindow" xmlns="ht ...

  9. Wow6432Node

    64 位版本 Windows 中的注册表分为 32 位注册表项和 64 位注册表项.许多 32 位注册表项与其相应的 64 位注册表项同名,反之亦然. 64 位版本 Windows 包含的默认 64 ...

  10. Win10《芒果TV》商店版更新v3.2.0：全新播放体验，跟着爸爸，想去哪就去哪

    喜迎十一月黑五大促,跟着爸爸,想去哪就去哪,<芒果TV>UWP版迅速更新v3.2.0版,全新播放页华丽蜕变,新增互动评论.猜你喜欢.宽窄屏适配.多窗体模式切换. 芒果TV UWP V3.2 ...