Lor是一个运行在OpenResty上的基于Lua编写的Web框架.
- 路由采用Sinatra风格，结构清晰，易于编码和维护.
- API借鉴了Express的思路和设计，Node.js跨界开发者可以很快上手.
- 支持多种路由，路由可分组，路由匹配支持正则模式.
- 支持middleware机制，可在任意路由上挂载中间件.
- 可作为HTTP API Server，也可用于构建传统的Web应用.
- 简单示例项目lor-example
- 全站示例项目openresty-china
特别注意: 在使用lor之前请首先确保OpenResty已安装，并将nginx/resty命令配置到环境变量中。即在命令行直接输入nginx -v、resty -v能正确执行。
一个简单示例(更复杂的示例或项目模板请使用lord命令生成)：
local lor = require("lor.index")
local app = lor()
app:get("/", function(req, res, next)
res:send("hello world!")
end)
-- 路由示例: 匹配/query/123?foo=bar
app:get("/query/:id", function(req, res, next)
local foo = req.query.foo
local path_id = req.params.id
res:json({
foo = foo,
id = path_id
})
end)
-- 错误处理插件，可根据需要定义多个
app:erroruse(function(err, req, res, next)
-- err是错误对象
ngx.log(ngx.ERR, err)
if req:is_found() ~= true then
return res:status(404):send("sorry, not found.")
end
res:status(500):send("server error")
end)
app:run()使用Makefile安装lor框架:
git clone https://github.com/sumory/lor
cd lor
make install默认lor的运行时lua文件会被安装到/usr/local/lor下， 命令行工具lord被安装在/usr/local/bin下。
如果希望自定义安装目录， 可参考如下命令自定义路径：
make install LOR_HOME=/path/to/lor LORD_BIN=/path/to/lord执行默认安装后, lor的命令行工具lord就被安装在了/usr/local/bin下, 通过which lord查看:
$ which lord
/usr/local/bin/lord
lor的运行时包安装在了指定目录下, 可通过lord path命令查看。
opm是OpenResty即将推出的官方包管理器，从v0.2.2开始lor支持通过opm安装：
opm install sumory/lor
注意： 目前opm不支持安装命令行工具，所以此种方式安装后不能使用lord命令。
除使用以上方式安装外, Mac用户还可使用homebrew来安装lor, 该方式由@syhily提供， 更详尽的使用方法请参见这里。
$ brew tap syhily/lor
$ brew install lor
至此， lor框架已经安装完毕，接下来使用lord命令行工具快速开始一个项目骨架.
$ lord -h
lor ${version}, a Lua web framework based on OpenResty.
Usage: lord COMMAND [OPTIONS]
Commands:
new [name] Create a new application
start Starts the server
stop Stops the server
restart Restart the server
version Show version of lor
help Show help tips
执行lord new lor_demo，则会生成一个名为lor_demo的示例项目，然后执行：
cd lor_demo
lord start
之后访问http://localhost:8888/， 即可。
更多使用方法，请参考use cases测试用例。
https://github.com/syhily/homebrew-lor由@syhily维护。
有一个QQ群用于在线讨论: 522410959