Lua - Web 网络编程

Lua 是一种高度灵活的语言，它经常用于多个平台，包括 Web 应用程序。 Kepler 社区成立于 2004 年，旨在提供 Lua 中的开源 Web 组件。

尽管已经开发了其他使用 Lua 的 Web 框架，但我们将主要关注 Kepler 社区提供的组件。

应用程序和框架

Orbit 是一个用于 Lua 的 MVC Web 框架，基于 WSAPI。
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")

-- Sample page

function my_home_page()

   return [[
      <head></head>
      <html>
         <h2>First Page</h2>
      </html>
   ]]
	
end

现在，您应该可以启动您的 Web 浏览器了。转到 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-based systems

WSAPI 支持的服务器和接口包括，

CGI
FastCGI
Xavante

WSAPI 提供了许多库，这使得我们在使用 Lua 进行 Web 编程时更加容易。 Lua 中支持的一些功能包括:

Request 请求处理
输出缓冲
身份验证
文件上传
Request 请求隔离
多路复用

一个简单的 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 网络组件

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 应用程序并帮助您进行强大的操作。

Lua 教程

Lua 基础教程

Lua 高级教程

Lua 库

Lua 其他