Lua web 编程
Lua 是一种高度灵活的语言,它经常用于多个平台,包括 Web 应用程序。 Kepler 社区成立于 2004 年,旨在提供 Lua 中的开源 Web 组件。
尽管已经开发了其他使用 Lua 的 Web 框架,但我们将主要关注 Kepler 社区提供的组件。
应用程序和框架
- Orbit 是一个基于 WSAPI 的 Lua MVC Web 框架。
- WSAPI 是从 Lua Web 应用程序中抽象出 Web 主机服务器的 API,是许多项目的基础。
- Xavante 是一个提供 WSAPI 接口的 Lua Web 服务器。
- Sputnik 是一个基于 Kepler 项目的 WSAPI 开发的 wiki/CMS,用于幽默和娱乐。
- CGILua 提供基于 WSAPI 但不再支持的 LuaPages 和 LuaScripts 网页创建。 请改用 Orbit、Sputnik 或 WSAPI。
在本教程中,我们将介绍 Lua 可以做什么,并了解更多关于其安装和使用的信息,请参阅 kepler 网站
Orbit
Orbit 是一个用于 Lua 的 MVC Web 框架。 它完全放弃了“脚本”的 CGILua 模型,转而支持应用程序,每个 Orbit 应用程序都可以放在一个文件中,但如果需要,我们可以将其拆分为多个文件。
所有 Orbit 应用程序都遵循 WSAPI 协议,因此它们目前与 Xavante、CGI 和 Fastcgi 一起使用。 它包括一个启动器,可以轻松启动 Xavante 实例进行开发。
安装 Orbit 最简单的方法是使用 LuaRocks。 Luarocks install 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 和 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
文件可以在本地覆盖配置。
<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>
重新启动服务器以确保所做的更改生效。
要启用我们的应用程序,我们需要将 +ExecCGI
添加到 Orbit
应用程序根目录中的 .htaccess
文件中 - 在本例中为 /var/www。
Options +ExecCGI
DirectoryIndex index.ws
简单示例 - Orbit
#!/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")
-- 简单页面
function my_home_page()
return [[
<head></head>
<html>
<h2>First Page</h2>
</html>
]]
end
现在,我们应该可以启动我们的浏览器了。 转到 http://localhost:8080/
你应该会看到以下输出
First Page
Orbit 提供了另一种选择,即 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 充当许多项目的基础,并嵌入了多种特性。 您可以使用 WSAPI 并支持以下平台,
- Windows
- 基于 UNIX 的系统
WSAPI 支持的服务器和接口包括:
- CGI
- FastCGI
- Xavante
WSAPI 提供了许多库,这使得我们在使用 Lua 进行 Web 编程时更加容易。 Lua 中支持的一些功能包括:
- 请求处理
- 输出缓冲
- 验证
- 文件上传
- 请求隔离
- 多路复用
一个简单的 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 是一个 Lua HTTP 1.1 Web 服务器,它使用基于 URI 映射处理程序的模块化架构。 Xavante 目前提供,
- 文件处理程序
- 重定向处理程序
- WSAPI 处理程序
文件处理程序用于一般文件。 重定向处理程序启用 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 框架和组件可供我们使用,并且可以根据需要进行选择。 还有其他可用的 Web 框架,包括以下
- Moonstalk 支持高效开发和托管使用 Lua 语言构建的动态生成的基于 Web 的项目; 从基本页面到复杂的应用程序。
- Lapis,一个使用 MoonScript(或 Lua)构建 Web 应用程序的框架,它运行在一个名为 OpenResty 的 Nginx 的定制版本中。
- Lua Server Pages 是一个 Lua 脚本引擎插件,它颠覆了任何其他嵌入式 Web 开发方法,为传统的 C 服务器页面提供了一条捷径。
这些 Web 框架可以利用我们的 Web 应用程序并帮助我们进行强大的操作。