Lua Web編程

Lua是高度靈活的語言，它往往是在多個平臺，包括Web應用程序中使用。成立2004年的Kepler社區提供Lua的Web組件開放源碼。

雖然，也有使用Lua已經開發了其他的web框架，我們將主要集中在Kepler社區提供的組件。

應用程序和框架

Orbit 是一個lua的MVC Web框架，它是基於WSAPI。
WSAPI是從Lua的Web應用程序抽象的Web主機服務器，是基於許多項目的API。
Xavante是一個Lua的Web服務器，提供了一個WSAPI接口。
Sputnik是一個wiki/CMS開發過WSAPI的Kepler項目用於娛樂和搞笑。
CGILua提供LuaPages和LuaScripts網頁製作的基礎上的WSAPI，但不再支持。使用Orbit, Sputnik 或WSAPI 代替。

在本教程中，我們會盡量讓你可以做更多地瞭解Lua，它的安裝和使用方法，請參考kepler網站

Orbit

Orbit是lua一個MVC Web框架。它徹底拋棄CGILua 的應用，每個應用程序Orbit可以容納一個單一文件「腳本」的CGILua模式，但是如果想讓它分割成多個文件也可以。

所有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, AND 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

重新啓動服務器，以確保變化生效。

爲了使可以訪問應用程序，需要+ ExecCGI添加到htaccess文件中的Orbit 應用程序的根- 在這種情況下，設置爲 /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 [[

First Page

]]
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.htmllify(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.htmllify(wrap,test)

print(test())

你可以在官方網站上找到一個很長的orbit教程

WSAPI

如前面提到的，WSAPI充當基礎由許多項目嵌入其中的多個特徵。可以使用WASAPI並支持以下平臺，

Windows
UNIX-based systems

支持的服務器和接口由WSAPI包括：

CGI
FastCGI
Xavante

WSAPI提供了大量的使用Lua庫，這使得我們更容易在網絡編程。一些支持的功能在Lua包括，

Request processing
Output buffering
Authentication
File uploads
Request isolation
Multiplexing

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("")
coroutine.yield("

Hello Wsapi!

")
coroutine.yield("

PATH_INFO: " .. wsapi_env.PATH_INFO .. "

")
coroutine.yield("

SCRIPT_NAME: " .. wsapi_env.SCRIPT_NAME .. "

")
coroutine.yield("")
end

return 200, headers, coroutine.wrap(hello_text)
end

你可以在一個簡單的HTML頁面組成，回到上面的代碼中看到。可以看到協程的使用，使得它可以通過語句返回語句來調用函數。最後HTML狀態碼（200），頭和HTML頁面返回。

Xavante

Xavante是使用基於URI的模塊化架構一個Lua1.1的HTTP Web服務器映射處理程序。 Xavante目前提供，

File handler
Redirect handler
WSAPI handler

文件處理程序是用於一般文件。重定向處理enabes的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框架，並提供給我們，並根據需要組成部分，它可以作爲選件。還有包括其他可用的Web框架，

Moonstalk 能夠有效地開發和託管建成Lua語言動態生成基於網絡的項目;從基本的網頁到複雜的應用程序
Lapis, 構建用MoonScript（或LUA）Web應用程序的框架運行的Nginx的定製版名爲OpenResty。
Lua Server Pages, 一個Lua腳本引擎插件任何其他方法，以嵌入式網絡的發展，提供了一個戲劇性的捷徑傳統的C服務器頁面。

這些Web框架可以利用Web應用程序，並幫助在做強大的操作。

Lua教程

Lua常用庫

應用程序和框架

Orbit

安裝Apache

安裝 LUAROCKS

安裝WSAPI, FCGI, ORBIT, AND XAVANTE

建立APACHE2

簡單的例子- Orbit

First Page

創建表單

WSAPI

Xavante

Lua Web組件

截至注意