Lua - Web程式設計



Lua 是一種高度靈活的語言,它經常用於多個平臺,包括 Web 應用程式。Kepler 社群成立於 2004 年,旨在提供 Lua 的開源 Web 元件。

儘管已經開發出其他使用 Lua 的 Web 框架,但我們將主要關注 Kepler 社群提供的元件。

應用程式和框架

  • Orbit 是一個基於 WSAPI 的 Lua MVC Web 框架。

  • WSAPI 是一個 API,它將 Web 宿主伺服器與 Lua Web 應用程式抽象出來,並且是許多專案的基石。

  • Xavante 是一個提供 WSAPI 介面的 Lua Web 伺服器。

  • Sputnik 是一個基於 Kepler 專案的 WSAPI 上開發的維基/CMS,用於幽默和娛樂。

  • CGILua 提供 LuaPages 和 LuaScripts 網頁建立,基於 WSAPI,但不再受支援。請改用 Orbit、Sputnik 或 WSAPI。

在本教程中,我們將嘗試讓您瞭解 Lua 的功能,並瞭解有關其安裝和用法的更多資訊,請參考 kepler 網站

Orbit

Orbit 是一個用於 Lua 的 MVC Web 框架。它完全放棄了 CGILua 的“指令碼”模型,轉而採用應用程式,其中每個 Orbit 應用程式都可以放在單個檔案中,但如果需要,也可以將其拆分成多個檔案。

所有 Orbit 應用程式都遵循 WSAPI 協議,因此它們目前可與 Xavante、CGI 和 Fastcgi 一起使用。它包含一個啟動器,可以輕鬆啟動 Xavante 例項進行開發。

安裝 Orbit 最簡單的方法是使用 LuaRocks。`luarocks install 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

在配置檔案的 `` 部分下方新增以下部分。如果此部分具有“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

index.lua

#!/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 瀏覽器。轉到 https://:8080/,您應該會看到以下輸出:

First Page

Orbit 提供了另一種選擇,即 Lua 程式碼可以生成 html。

index.lua

#!/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())

建立表單

下面顯示了一個簡單的表單示例:

index.lua

#!/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!</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.sitename.com"] = simplerules
   }
}

Lua Web 元件

  • 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 應用程式並幫助您執行強大的操作。

廣告
© . All rights reserved.