平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“Lua下基本的网络编程示例”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。
落到代码里,Lua是高度灵活的语言,它往往是在多个平台,包括Web应用程序中采用。成立2004年的Kepler社区提供Lua的Web组件开放源码。
落到代码里,虽然,也有采用Lua已经开发了其他的web框架,我们将主要集中在Kepler社区提供的组件。
应用程序和框架
- Orbit 是一个lua的MVC Web框架,它是基于WSAPI。
- 落到代码里,WSAPI是从Lua的Web应用程序抽象的Web主机服务器,是基于许多项目的API。
- Xavante是一个Lua的Web服务器,提供了一个WSAPI接口。
- 实际处理时,Sputnik是一个wiki/CMS开发过WSAPI的Kepler项目用来娱乐和搞笑。
- 实际处理时,CGILua提供LuaPages和LuaScripts网页制作的基础上的WSAPI,但不再兼容。采用Orbit, Sputnik 或WSAPI 代替。
实际处理时,在本教程里,我们会尽量让你能够做更多地了解Lua,它的安装和采用方法,请参考kepler网站
Orbit
落到代码里,Orbit是lua一个MVC Web框架。它彻底抛弃CGILua 的应用,每个应用程序Orbit能够容纳一个单一文件“脚本”的CGILua模式,但是如果想让它分割成多个文件也能够。
在这个场景下,所有Orbit应用程序遵循WSAPI协议,所以他们目前正在与Xavante,CGI和FastCGI的一起结合工作。它包括一个发射器,能够很容易推出Xavante实例进行开发。
在这个场景下,安装Orbit的最轻松方法是采用LuaRocks。 luarocks安装Orbit的安装命令。对于这一点,首先需先安装LuaRocks。
实际处理时,若还没有安装所有的依赖,这是应遵循在的Unix / Linux环境设置Orbit的步骤。
安装Apache
结合项目来看,连接到服务器。安装Apache2,它兼容的模块和能采用所需的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, AND 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”,这样htaccess文件能够覆盖设置。
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>
重新启动服务器,以确保变化生效。
实际处理时,为便于使能够访问应用程序,需+ ExecCGI添加到htaccess文件中的Orbit 应用程序的根- 在这种情况下,设置为 /var/www。
DirectoryIndex index.ws
轻松的例子- Orbit
-- 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
现在,应该能够启动Web浏揽器同时转到(链接已移除),应该看到
Orbit 提供了另一种选择,那就是Lua代码能够生成html。
-- index.lua
require"orbit"
function generate()
return html {
head{title "HTML Example"},
body{
h2{"Here we go again!"}
}
}
end
orbit.htmllify(generate)
print(generate())
新建表单
一种轻松形式的例子如下所示所示。
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.htmllify(wrap,test)
print(test())
你能够在官方网站上找到一个很长的orbit教程
WSAPI
在这个场景下,如前面提到的,WSAPI充当基础由许多项目嵌入其中的多个特征。能够采用WASAPI同时兼容以下平台,
- Windows
- UNIX-based systems
兼容的服务器和接口由WSAPI包括:
- CGI
- FastCGI
- Xavante
实际处理时,WSAPI提供了大量的采用Lua库,这使得我们更容易在网络编程。一些兼容的功能在Lua包括,
- Request processing
- Output buffering
- Authentication
- File uploads
- Request isolation
- Multiplexing
WSAPI一个轻松的例子如下所示所示。
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.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将改为类似。
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框架,同时提供给我们,并根据需组成部分,它能够作为选件。还有包括其他可用的Web框架,
- Moonstalk 能够有效地开发和托管建成Lua语言动态生成基于网络的项目;从基本的网页到复杂的应用程序
- 实际处理时,Lapis, 构建用MoonScript(或LUA)Web应用程序的框架运行的Nginx的定制版名为OpenResty。
- 实际处理时,Lua Server Pages, 一个Lua脚本引擎插件任何其他方法,以嵌入式网络的发展,提供了一个戏剧性的捷径传统的C服务器页面。
这些Web框架能够借助Web应用程序,同时帮助在做强大的操作。