Lua Web编程

Lua Web编程

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

尽管已经有很多Lua Web开发是使用Lua的Web框架，但这里主要介绍和使用Kepler社区提供的组件。

Lua常用应用程序和框架

  • Orbit - Orbit是Lua的MVC Web框架，基于WSAPI。
  • WSAPI - WSAPI是从Lua Web应用程序抽象Web主机服务器的API，是许多项目的基础。
  • Xavante - 是一个提供WSAPI接口的Lua Web服务器。
  • Sputnik - 是一个wiki/CMS，通过用于幽默和娱乐的Kepler项目的WSAPI开发。
  • 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是安装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类系统

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 - by zyiz.net !</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.zyiz.net"] = simplerules
   }
}

Lua的Web组件

  • Copas - 一个基于协同程序的调度程序，可以由TCP/IP服务器使用。
  • Cosmo - 一个“安全模板”引擎，可以保护应用程序免受模板中任意代码的攻击。
  • Coxpcall - 它将Lua native pcall和xpcall与coroutine兼容。
  • 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常用库