Lua进阶教程（四）Web编程

hudson2022
234 阅读3分钟

Lua进阶教程（四）Web编程

hudson 译 原文

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

尽管有一些其他的使用Lua的网络框架，但我们将主要关注开普勒社区提供的组件。

应用程序和框架

  • Orbit 是Lua的MVC Web框架，基于WSAPI。

  • WSAPI 是从Lua Web应用程序中抽象Web主机服务器的API，是许多项目的基础。

  • Xavante 是一个提供WSAPI接口的Lua Web服务器。

  • Sputnik 是一个wiki/CMS系统，用于幽默和娱乐。它使用开普勒项目上的WSAPI开发。

  • CGILua提供基于WSAPI的LuaPages和LuaScripts网页创建，但不再受支持。 改用Orbit、Sputnik或WSAPI。

本教程主要介绍Lua在Web编程方面可以做什么。如果想了解更多关于其安装和使用的信息，请参考开普勒网站。

Orbit

Orbit是Lua的MVC网络框架。 它完全放弃了的CGILua “脚本”模型，转而支持应用程序，其中每个Orbit应用程序可以放在单个文件中，但如果愿意，也可以将其拆分为多个文件。

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

安装Orbit的最简单方法是使用LuaRocks， 为此，首先需要安装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

现在启动浏览器,转到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进行网络编程。 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处理器进行处理。

一个简单的例子如下所示。

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服务器页面提供了一条戏剧性的捷径。

avatar
文章
阅读
粉丝