上一节:
下一节:

  Lua - 网络编程

  • 简述

    Lua 是一种高度灵活的语言，它经常用于多种平台，包括 Web 应用程序。Kepler 社区成立于 2004 年，旨在提供 Lua 中的开源 Web 组件。
    尽管已经开发了其他使用 Lua 的 Web 框架，但我们将主要关注 Kepler 社区提供的组件。

  • 应用程序和框架

    • Orbit 是一个基于 WSAPI 的 Lua MVC Web 框架。
    • 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 安装轨道是安装命令。为此，您需要安装 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
    现在，您应该可以启动 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 并支持以下平台，
    • 视窗
    • 基于 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&gtHello Wsapi!</p>")
      coroutine.yield("<p&gtPATH_INFO: " .. wsapi_env.PATH_INFO .. "</p>")
      coroutine.yield("<p&gtSCRIPT_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 网页组件

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