Lua - 网络编程

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

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

应用程序和框架

Orbit是 Lua 的 MVC Web 框架，基于 WSAPI。
WSAPI是从 Lua Web 应用程序中抽象出 Web 主机服务器的 API，是许多项目的基础。
Xavante是一个提供 WSAPI 接口的 Lua Web 服务器。
Sputnik是一个在开普勒项目上通过 WSAPI 开发的 wiki/CMS，用于幽默和娱乐。
CGILua提供基于 WSAPI 的 LuaPages 和 LuaScripts 网页创建，但不再受支持。请改用 Orbit、Sputnik 或 WSAPI。

在本教程中，我们将尝试让您了解 Lua 可以做什么，并了解更多有关其安装和使用的信息，请参阅 kepler 网站

轨道

Orbit 是 Lua 的 MVC Web 框架。它完全放弃了 CGILua 的“脚本”模型，转而支持应用程序，其中每个 Orbit 应用程序都可以放入一个文件中，但如果需要，您可以将其拆分为多个文件。

所有 Orbit 应用程序都遵循 WSAPI 协议，因此它们目前可与 Xavante、CGI 和 Fastcgi 配合使用。它包括一个启动器，可以轻松启动 Xavante 实例进行开发。

安装 Orbit 最简单的方法是使用 LuaRocks。Luarocks install Orbit 是安装命令。为此，您需要先安装LuaRocks。

如果您尚未安装所有依赖项，请按照以下步骤在 Unix/Linux 环境中设置 Orbit。

安装阿帕奇

连接到您的服务器。安装 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

简单的例子 - 轨道

#!/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/，您应该看到以下输出 -

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
萨万特

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 是一个 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框架和组件非常多，我们可以根据需要进行选择。还有其他可用的网络框架，包括以下内容 -

Moonstalk能够高效开发和托管使用 Lua 语言构建的动态生成的基于 Web 的项目；从基本页面到复杂的应用程序。
Lapis是一个使用 MoonScript（或 Lua）构建 Web 应用程序的框架，该框架在名为 OpenResty 的 Nginx 定制版本内运行。
Lua Server Pages是一个 Lua 脚本引擎插件，它超越了任何其他嵌入式 Web 开发方法，为传统 C 服务器页面提供了一条戏剧性的捷径。

这些 Web 框架可以利用您的 Web 应用程序并帮助您执行强大的操作。