lapis入門

endless_road 發(fā)布于2019-07-25 13:52 / 2959人閱讀

摘要：入門是為和編寫的框架。使用來安裝創(chuàng)建一個應(yīng)用命令行工具附帶了一個命令行工具，可幫助您創(chuàng)建新項目和啟動服務(wù)器。在生產(chǎn)環(huán)境中，應(yīng)當(dāng)啟用緩存以獲得最佳性能。指令指定一個代碼塊，它將處理與其他不匹配的任何請求。將忽略常規(guī)的二進(jìn)制文件。

lapis入門

Lapis 是為 Lua 和 MoonScript 編寫的 Web 框架。 Lapis 很有趣，因為它建立在Nginx 發(fā)行的 OpenResty 之上。您的 Web 應(yīng)用程序直接在 Nginx 內(nèi)部運(yùn)行。 Nginx 的事件循環(huán)允許您使用 OpenResty 提供的模塊進(jìn)行異步 HTTP 請求，數(shù)據(jù)庫查詢和其他請求。 Lua 的協(xié)程允許你編寫在后臺事件驅(qū)動的同步代碼。除了提供Web框架，Lapis還提供了用于在不同配置環(huán)境中控制OpenResty的工具。即使你不想使用Web框架，但如果你使用OpenResty，你也許會發(fā)現(xiàn)它依舊是是有用的。

這個 Web 框架實(shí)現(xiàn)了 URL 路由器，HTML 模板，CSRF 和會話支持，PostgreSQL 或 MySQL 支持的主動記錄系統(tǒng)，用于處理 model 和開發(fā)網(wǎng)站所需的一些其他有用的功能。

本指南希望能夠給大家作為一個教程和參考

基本設(shè)置

將OpenResty安裝到系統(tǒng)上。如果你使用Heroku，那么你可以使用Heroku OpenResty模塊和Lua構(gòu)建包。

使用luarocks來安裝lapis

luarocks install lapis

創(chuàng)建一個應(yīng)用

lapis 命令行工具

Lapis附帶了一個命令行工具，可幫助您創(chuàng)建新項目和啟動服務(wù)器。要看看Lapis能做什么，在你的shell中運(yùn)行lapis help

現(xiàn)在，我們將創(chuàng)建一個新項目。切換到一個干凈的目錄并運(yùn)行如下命令：

lua new
wrote   nginx.conf
wrote   mime.types
wrote   app.moon

Lapis編寫一個基本的 Nginx 配置和一個空白 Lapis 應(yīng)用程序。

隨意查看生成的配置文件（nginx.conf是唯一重要的文件）。以下是它的功能的簡要概述：

任何請求在/static/將提供靜態(tài)文件（如果你要提供這個功能，你可以創(chuàng)建這個目錄）

對/favicon.ico的請求則響應(yīng)/static/favicon.ico這個文件

然后所有其他請求將由Lua提供，更具體地說是一個名為“app”的模塊

當(dāng)您使用lapis命令行工具啟動服務(wù)器時，將處理nginx.conf文件，并使用當(dāng)前 Lapis 環(huán)境中的值填充模板變量。這將在下面更詳細(xì)地討論。

nginx 配置

讓我們來看看 lapis new 給我們的配置。雖然沒有必要立即查看，但如果想要構(gòu)建更高級的應(yīng)用程序或者甚至只是想將應(yīng)用程序部署到生產(chǎn)環(huán)境，那么了解它是很重要的。

這里是生成的nginx.conf：

worker_processes ${{NUM_WORKERS}};
error_log stderr notice;
daemon off;

events {
  worker_connections 1024;
}

http {
  include mime.types;

  server {
    listen ${{PORT}};
    lua_code_cache ${{CODE_CACHE}};

    location / {
      default_type text/html;
      content_by_lua "
        require("lapis").serve("app")
      ";
    }

    location /static/ {
      alias static/;
    }

    location /favicon.ico {
      alias static/favicon.ico;
    }
  }
}

首先要注意的是，這不是一個正常的Nginx配置文件。 Lapis 使用特殊的${{VARIABLE}}語法在啟動服務(wù)器之前注入環(huán)境設(shè)置。

error_log stderr notice 和 daemon off讓我們的服務(wù)器在前臺運(yùn)行，并將日志打印到控制臺。這對于開發(fā)時是很好的，但是在生產(chǎn)時一定要關(guān)閉

lua_code_cache 對于開發(fā)時也是另一個有用的設(shè)置。當(dāng)設(shè)置為 off 時，將導(dǎo)致所有Lua 模塊在每個請求時重新加載。對 Web 應(yīng)用程序的源代碼的修改可以自動重載。在生產(chǎn)環(huán)境中，應(yīng)當(dāng)啟用（on）緩存以獲得最佳性能。默認(rèn)為off。

content_by_lua 指令指定一個 Lua 代碼塊，它將處理與其他 location 不匹配的任何請求。它加載 Lapis 并告訴它為名為 app 的模塊提供服務(wù)。之前運(yùn)行的 lapis new 提供了一個框架模塊app來開始

啟動服務(wù)器

雖然可以手動啟動 Nginx ，但是 Lapis 包裝了一個方便的命令去構(gòu)建配置和啟動服務(wù)器。

在 shell 中運(yùn)行 lapis server 將啟動服務(wù)器。 Lapis 將嘗試查找您的OpenResty安裝。它將搜索以下目錄中的nginx二進(jìn)制文件。（最后一個代表你PATH中的任何東西）

"/usr/local/openresty/nginx/sbin/"
"/usr/local/opt/openresty/bin/"
"/usr/sbin/"
""

記住，你需要 OpenResty 而不是正常安裝 Nginx。 Lapis 將忽略常規(guī)的 Nginx 二進(jìn)制文件。

請繼續(xù)并啟動服務(wù)器，看看它是什么樣子：
lapis server

默認(rèn)配置將服務(wù)器置于前臺運(yùn)行，使用CTRL + C停止服務(wù)器。
如果服務(wù)器在后臺運(yùn)行，可以使用 lapis term 停止。它必須在應(yīng)用程序的根目錄中運(yùn)行。此命令查找正在運(yùn)行的服務(wù)器的PID文件，并向該進(jìn)程發(fā)送 TERM 消息（如果存在）

創(chuàng)建一個應(yīng)用

現(xiàn)在你知道如何生成一個新項目并啟動和停止服務(wù)器，你已經(jīng)準(zhǔn)備好開始編寫應(yīng)用程序代碼。本指南分為 MoonScript 和 Lua 兩個。

如果你不確定要使用什么，我建議通過兩個路徑閱讀。

Create an application with Lua
Create an application with MoonScript