Lua教程

Lua - 网络编程

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

尽管还有其他使用Lua的Web框架已经开发，但我们将主要关注由开普勒社区提供的组件.

应用程序和框架

轨道是基于WSAPI的Lua的MVC Web框架.
WSAPI 是抽象Web主机的API来自Lua Web应用程序的服务器，是许多项目的基础.
Xavante 是一个提供WSAPI接口的Lua Web服务器.
Sputnik 是在Kepler项目上通过WSAPI开发的wiki/CMS，用于幽默和娱乐.
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安装轨道是安装的命令.为此，您需要首先安装<a rel="nofollow" target="_blank" href = "https://img01.yuandaxia.cn/Content/img/tutorials/lua/wiki LuaRocks.

如果你还没有安装所有依赖项，下面是在Unix/Linux环境中设置Orbit时要遵循的步骤.

安装Apache

Connect安装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

现在，您应该可以启动网络浏览器了.转到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&gt")
      coroutine.yield("<p&gtHello Wsapi!</p&gt")
      coroutine.yield("<p&gtPATH_INFO: " .. wsapi_env.PATH_INFO .. "</p&gt")
      coroutine.yield("<p&gtSCRIPT_NAME: " .. wsapi_env.SCRIPT_NAME .. "</p&gt")
      coroutine.yield("</body&gt</html&gt")
   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
   }
}