0%

openresty用mvc框架配置测试

openresty mvc框架
常用Lua开发库3-模板渲染
动态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

1
2
3
4
5
cd /usr/example/lualib/resty/  
wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template.lua
mkdir /usr/example/lualib/resty/html
cd /usr/example/lualib/resty/html
wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template/html.lua

模板位置定义

我们需要告诉lua-resty-template去哪儿加载我们的模块,此处可以通过set指令定义template_location、template_root或者从root指令定义的位置加载。
如我们可以在example.conf配置文件的server部分定义

1
2
3
4
#first match ngx location  
set $template_location "/templates";
#then match root read file
set $template_root "/usr/example/templates";

也可以通过在server部分定义root指令
root /usr/example/templates;

其顺序是

1
2
3
4
5
6
7
8
9
10
11
12
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/example/templates
mkdir /usr/example/templates2

example.conf配置server部分

1
2
3
4
5
6
7
8
9
#first match ngx location  
set $template_location "/templates";
#then match root read file
set $template_root "/usr/example/templates";

location /templates {
internal;
alias /usr/example/templates2;
}

首先查找/usr/example/template2,找不到会查找/usr/example/templates。

然后创建两个模板文件

1
vim /usr/example/templates2/t1.html  

内容为
template2

1
vim /usr/example/templates/t1.html

内容为

1
template1  
1
2
mkdir -p /usr/example/lua/
vi /usr/example/lua/test_template_1.lua
1
2
local template = require("resty.template")  
template.render("t1.html")

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

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

API

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

1、test_template_2.lua

1
vi /usr/example/lua/test_template_2.lua

内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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)

2、examle.conf配置文件

1
2
3
4
5
location /lua_template_2 {  
default_type 'text/html';
lua_code_cache on;
content_by_lua_file /usr/example/lua/test_template_2.lua;
}

使用示例

1、test_template_3.lua

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
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)

请确认文件编码为UTF-8;context即我们渲染模板使用的数据。

2、模板文件/usr/example/templates/t3.html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{(header.html)}  
<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-}
{(footer.html)}

include_file:包含另一个模板文件;

var :变量输出;
var :变量转义输出;
code :代码片段;
comment :注释;
raw:中间的内容不会解析,作为纯文本输出;

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

3、example.conf配置文件

1
2
3
4
5
location /lua_template_3 {  
default_type 'text/html';
lua_code_cache on;
content_by_lua_file /usr/example/lua/test_template_3.lua;
}

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

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

参考:http://jinnianshilongnian.iteye.com/blog/2187775

使用Nginx+Lua(OpenResty)开发高性能Web应用
第一章 安装Nginx+Lua开发环境
第二章 Nginx+Lua开发入门
第三章 Redis/SSDB+Twemproxy安装与使用
第四章 Lua模块开发
第五章 常用Lua开发库1-redis、mysql、http客户端
第五章 常用Lua开发库2-JSON库、编码转换、字符串处理
第五章 常用Lua开发库3-模板渲染
第六章 Web开发实战1——HTTP服务
第七章 Web开发实战2——商品详情页
第八章 流量复制/AB测试/协程

http://geek.csdn.net/user/publishlist/lzz957748332

openresty官网:http://openresty.org/(中文版:http://openresty.org/cn/)

Nginx教程:https://openresty.org/download/agentzh-nginx-tutorials-zhcn.html

lua5.1文档:http://www.lua.org/manual/5.1/

openresty最佳实践:https://www.gitbook.com/book/moonbingbing/openresty-best-practices/details

Nginx-lua模块文档:https://github.com/openresty/lua-nginx-module

https://idevz.gitbooks.io/vanilla-zh/content/
https://github.com/idevz/vanilla
http://www.stuq.org/course/1015/study

https://moonbingbing.gitbooks.io/openresty-best-practices/content/base/web_evolution.html

https://github.com/362228416/openresty-web-dev
http://openresty.org/download/agentzh-nginx-tutorials-zhcn.html

QQ群:397745473

欢迎关注我的其它发布渠道