Lua Web开发
Lua Web开发
Lua是一种高度灵活的语言,它通常用于包括web应用程序在内的多种类型的平台中。在2004年成立的开普勒社区提供了Lua开源web组件。
尽管,Lua还有很多其他的web框架,但是我们将主要侧重于开普勒社区提供的组件。
应用程序和框架
Orbit是一个基于WSAPI的Lua MVCweb框架。
WSAPI是将web主机服务器从Lua web应用程序中抽象出来的API,是许多项目的基础。
Xavante 是一个提供wsapi接口的Luaweb服务器。
Sputnik是一个在开普勒项目上开发的维基项目,主要用于wiki/CMS。
CGILua提供了基于wsapi但不再支持的luapages和luascripts网页创建。
在本章中,我们将尝试让您理解Lua可以做什么,要了解更多关于其安装和使用的信息,请参阅开普勒网站
Orbit
Orbit是lua一个MVC Web框架。它彻底抛弃CGILua 的应用，每个应用程序Orbit可以容纳一个单一文件“脚本”的CGILua模式，但是如果想让它分割成多个文件也可以。
所有Orbit应用程序遵循WSAPI协议，所以他们目前正在与Xavante，CGI和FastCGI的一起结合工作。它包括一个launcher，可以很容易运行Xavante实例进行开发。
安装Orbit的最简单方法是使用LuaRocks。 luarocks是安装Orbit的命令。我们首先需要先安装LuaRocks。
如果你还没有安装所有的依赖，应遵循在的Unix/Linux环境设置Orbit的步骤。
安装Apache
链接到你的服务器安装Apache2,下面是步骤:
$ sudo apt-get install apache2 libapache2-mod-fcgid libfcgi-dev build-essential $ sudo a2enmod rewrite $ sudo a2enmod fcgid $ sudo /etc/init.d/apache2 force-reload
安装LuaRocks
$ sudo apt-get install luarocks 安装WSAPI, FCGI, Orbit和Xavante $ sudo luarocks install orbit $ sudo luarocks install wsapi-xavante $ sudo luarocks install wsapi-fcgi
设置Apache2
$ sudo raj /etc/apache2/sites-available/default
添加如下内容到配置文件的<Directory /var/www/>片段中. 如果该片段包含'AllowOverride None'那么你需要把'None'改成'All'
<IfModule mod_fcgid.c> AddHandler fcgid-script .lua AddHandler fcgid-script .ws AddHandler fcgid-script .op FCGIWrapper "/usr/local/bin/wsapi.fcgi" .ws FCGIWrapper "/usr/local/bin/wsapi.fcgi" .lua FCGIWrapper "/usr/local/bin/op.fcgi" .op #FCGIServer "/usr/local/bin/wsapi.fcgi" -idle-timeout 60 -processes 1 #IdleTimeout 60 #ProcessLifeTime 60 </IfModule>
重启Apahce已确认你的修改已生效.
要激活你的应用,你需要添加+ExecCGI到你的Orbit应用根目录下的.htaccess文件,在这个例子中是/var/www.
Options +ExecCGI DirectoryIndex index.ws
简单的例子
#!/usr/bin/env index.lua
-- index.lua
require"orbit"
-- declaration
module("myorbit", package.seeall, orbit.new)
-- handler
function index(web)
return my_home_page()
end
-- dispatch
myorbit:dispatch_get(index, "/", "/index")
-- Sample page
function my_home_page()
return [[
<head></head>
<html>
<h2>First Page</h2>
</html>
]]
end现在你可以打开你的浏览器.输入http://localhost:8080/就可以看到效果了
第一个页面
Orbit提供其他选项, i.e., Lua 代码可以生成html.
#!/usr/bin/env index.lua
-- index.lua
require"orbit"
function generate()
return html {
head{title "HTML Example"},
body{
h2{"Here we go again!"}
}
}
end
orbit.htmlify(generate)
print(generate())创建表单
下面是创建表单的实例:
#!/usr/bin/env index.lua
require"orbit"
function wrap (inner)
return html{ head(), body(inner) }
end
function test ()
return wrap(form (H'table' {
tr{td"First name",td( input{type='text', name='first'})},
tr{td"Second name",td(input{type='text', name='second'})},
tr{ td(input{type='submit', value='Submit!'}),
td(input{type='submit',value='Cancel'})
},
}))
end
orbit.htmlify(wrap,test)
print(test())WSAPI
如前面提到的，WSAPI充当基础由许多项目嵌入其中的多个特征。可以使用WASAPI并支持以下平台，
Windows
基于UNIX的操作系统
支持的服务器和接口由WSAPI包括：
CGI
FastCGI
Xavante
WSAPI提供了大量的使用Lua库，这使得我们更容易在网络编程。一些支持的功能在Lua包括，
Request processing
Output buffering
Authentication
File uploads
Request isolation
Multiplexing
WSAPI一个简单的例子如下所示。
#!/usr/bin/env wsapi.cgi
module(..., package.seeall)
function run(wsapi_env)
local headers = { ["Content-type"] = "text/html" }
local function hello_text()
coroutine.yield("<html><body>")
coroutine.yield("<p>Hello Wsapi!</p>")
coroutine.yield("<p>PATH_INFO: " .. wsapi_env.PATH_INFO .. "</p>")
coroutine.yield("<p>SCRIPT_NAME: " .. wsapi_env.SCRIPT_NAME .. "</p>")
coroutine.yield("</body></html>")
end
return 200, headers, coroutine.wrap(hello_text)
end上面例子是一个简单的HTML页面。在代码中你可以看到协程的使用，使得它可以通过语句返回语句来调用函数,最后返回HTML状态码（200），头和HTML页面返回。
Xavante
Xavante是使用基于URI的模块化架构一个Lua1.1的HTTP Web服务器映射处理程序。 Xavante目前提供，
File handler
Redirect handler
WSAPI handler
文件处理程序是用于一般文件。重定向处理enabes的URI重新映射和WSAPI处理与WSAPI申请。
一个简单的例子如下所示。
require "xavante.filehandler"
require "xavante.cgiluahandler"
require "xavante.redirecthandler"
-- Define here where Xavante HTTP documents scripts are located
local webDir = XAVANTE_WEB
local simplerules = {
{ -- URI remapping example
match = "^[^%./]*/$",
with = xavante.redirecthandler,
params = {"index.lp"}
},
{ -- cgiluahandler example
match = {"%.lp$", "%.lp/.*$", "%.lua$", "%.lua/.*$" },
with = xavante.cgiluahandler.makeHandler (webDir)
},
{ -- filehandler example
match = ".",
with = xavante.filehandler,
params = {baseDir = webDir}
},
}
xavante.HTTP{
server = {host = "*", port = 8080},
defaultHost = {
rules = simplerules
},
}如果Xavante使用虚拟主机，调用xavante.HTTP将改为类似。
xavante.HTTP{
server = {host = "*", port = 8080},
defaultHost = {},
virtualhosts = {
["www.sitename.com"] = simplerules
}
}Lua Web组件
Copas,基于协程调度器可以使用通过TCP/IP协议的服务器。
Cosmo, “安全模板”引擎，它可以防止在模板中任意代码的应用程序。
Coxpcall Lua封装原生pcall和xpcall与协程相容的。
LuaFileSystem, 可移植的方式来访问底层的目录结构和文件属性。
Rings, 一个库，它提供了一种从内Lua创建新的Lua状态。
注意
现在网络上有很多基于Lua的web框架，我们可以根据需要选择性使用/
Moonstalk 能够有效地开发和托管建成Lua语言动态生成基于网络的项目;从基本的网页到复杂的应用程序
Lapis, 构建用MoonScript（或LUA）Web应用程序的框架运行的Nginx的定制版名为OpenResty。
Lua Server Pages, 一个Lua脚本引擎插件任何其他方法，以嵌入式网络的发展，提供了一个戏剧性的捷径传统的C服务器页面。