Lapis安装与项目创建

2.2k 词

Lapis是程序员leaf写的一个lua语言的WEB框架,目前已经发布了1.3版本。要求的服务器开发环境是Openresty,而且支持moonscript,这个moonscript语言类似于Javascript的coffescript。起到的作用是,可以用简短moonscript实现你的任务,然后通过翻译程序把moonscript翻译成lua语言。

Lapis还提供了命令行工具,用来管理nginx实例的启动,关闭,重新加载。

1.安装luarocks.

在Lua语言生态工具中,有一个类似于Python的Pip一样的引用管理工具,叫做Luarocks。这个工具可以方便的安装,目前在Lua世界中很多的软件包。而如果正好使用的Linux是Ubuntu系统,使用sudo apt-get install luarocks就可以安装Luarocks了。

2.Lapis的安装:

当在Linux系统上安装完luarocks之后,使用如下命令就可以安装lapis:

luarocks install lapis

因为lapis是在有openresty基础上运行,我们假设现在openresty已经安装好了。而lapis提供了命令行程序,提供了快捷的方式创建nginx工程实例和配置文件,并且可以通过lapis命令行,管理服务。

3.创建工程。

lapis命令行的名字是“lapis”

我们在shell环境下运行lapis命令航工具。

lapis help

这条命令显示lapis都有哪些子功能,首先我们先用命令创建一个lua的WEB工程。

lapis new

命令执行后,会在当前目录创建一个空应用,会生成三个文件。

app.moon

mime.types

nginx.conf

app.moon是自动生成的一个moonscript脚本,可以通过程序翻译成lua程序。

mime.types是文件类型描述汇集,会在nginx.conf中include包含进去。

nginx.conf就是典型的nginx配置文件。

目前这个阶段可能最需要讲的一下就是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;
    
    }

  }}

include mime.types;就是引用mime类型文件之前已经说了。

listen $;

定义监听的端口, PORT变量的设置,会在之后说明,如果在config文件中设置PORT变量。

lua_code_cache $;

code cache的设置也是可以在config文件中配置的。lua_code_cache 设定成on,每次编辑修改lua程序的时候,服务会自动的重载入,这在调试环境下也很有用,省去的重启的麻烦。

剩下的就是三个路由

location / {

这是一个根路由,输入网址后第一个被定为到的页面处理定义。

content_by_lua '

       require("lapis").serve("app")
   
     ';

这就话就是lua lapis程序的入口,location“/”的意思,你只要是输入服务器的IP:PORT,而不指定其他任何后缀,比如:127.0.0.1/,都会调用执行lapis应用(简单说,任何的请求都会执行app.lua脚本,只要在nginx.conf没有同名locate定义。),就是当前工程目录下app.lua的脚本。

location /static/ {

这定义了工程静态文件的位置,用于存放CSS,image,js等静态文件的位置。

location /favicon.ico {

这是一个图片,输入127.0.0.1/favicon.ico,就会在浏览器中显示出。设定我们的服务在前台运行。

error_log stderr notice;

这是在设定,log输出重定向输出到屏幕上。

daemon off;

这么设定对程序员调试很有用,而在实际的生产环境中,可以关掉此选项。配置文件基本注释完了。启动服务。

lapis server

用这条命令来启动一个ningx实例服务,用当前的目录的nginx.conf.lapis会在下面的目录,去搜索openresty的nginx执行文件。


"/usr/local/openresty/nginx/sbin/"

"/usr/local/opt/openresty/bin/"

"/usr/sbin/"

""

停止服务,用ctrl + c,或是使用命令lapis term 。

作者:糖果

PS:转载到其它平台请注明作者姓名及原文链接。