转载

Git 推荐 | 基于 Openresty 的 Web 应用框架

香草/Vanilla

香草/Vanilla是一个基于Openresty实现的高性能Web应用开发框架.

安装说明

Vanilla使用Luarocks管理包依赖
安装Luarocks（with lua5.1）
使用Openresty最新稳定版

安装示例 / Linux平台

yum install lua-devel luarocks  -- 需要安装Lua开发版 luarocks install vanilla

安装示例 / MacOSX平台

wget lua5.1(lua5.1 源码地址) 源码安装lua5.1 wget luarocks（luarocks源码地址） 源码安装luarocks luarocks install vanilla

为何建议Lua5.1版本

Openresty执行Lua需要基于Luajit加速，Luajit使用Lua5.1的ABI
Luarocks会根据Lua版本识别相应的包
Vanilla运行Openresty前需要基于Lua5.1做服务相关自动化配置

为何建议源码安装

源码安装更方便版本控制
尤其MacOSX10.9后brew默认安装的Lua是5.2版本，而Openresty必须源码安装5.1

使用

应用代码骨架生成及服务启动

vanilla new app_name cd app_name vanilla start [--trace]     -- 默认运行在development环境 VA_ENV=production vanilla start [--trace]  -- 运行在生产环境

代码目录结构说明

 /Users/zj-git/app_name/ tree ./ ./ ├── application（应用代码主体目录） │   ├── bootstrap.lua（应用初始化 / 可选<以下未标可选为必选>） │   ├── controllers(应用业务代码主体目录) │   │   ├── error.lua（应用业务错误处理，处理本路径下相应业务报错） │   │   └── index.lua（hello world示例） │   ├── library（应用本地类包） │   ├── models（应用数据处理类） │   │   ├── dao（数据层业务处理） │   │   │   └── table.lua │   │   └── service（服务化业务处理，对DAO的再次封装） │   │       └── user.lua │   ├── nginx（*Openresty所封装Nginx请求处理各Phase） │   │   └── init.lua（*init_by_lua示例） │   ├── plugins（插件目录） │   └── views（视图层，与controllers一一对应） │       ├── error（错误模板） │       │   └── error.html │       └── index（index controller模板） │           └── index.html ├── config（应用配置目录） │   ├── application.lua（应用基础配置 / 路由器、初始化等设置） │   ├── errors.lua（应用错误信息配置） │   ├── nginx.conf（nginx配置文件模板） │   ├── nginx.lua（服务各种运行环境配置 / 是否开启lua_code_cache等） │   ├── waf-regs（应用防火墙规则配置目录） │   │   ├── args │   │   ├── cookie │   │   ├── post │   │   ├── url │   │   ├── user-agent │   │   └── whiteurl │   └── waf.lua（服务防火墙配置） ├── logs（日志目录） │   └── hack（攻击日志目录 / 保持可写权限） ├── pub（应用Nginx配置根路径） │   └── index.lua（应用请求入口） └── spec（基于busted的单元测试路径）     ├── controllers     │   └── index_controller_spec.lua     ├── models     └── spec_helper.lua

业务代码示例 IndexController

local IndexController = {}  function IndexController:index()     local view = self:getView()     local p = {}     p['vanilla'] = 'Welcome To Vanilla...'     p['zhoujing'] = 'Power by Openresty'     view:assign(p)     return view:display() end  return IndexController

模板示例 views/index/index.html

<!DOCTYPE html> <html> <body>   <img src="http://m1.sinaimg.cn/maxwidth.300/m1.sinaimg.cn/120d7329960e19cf073f264751e8d959_2043_2241.png">   <h1><a href = 'https://github.com/idevz/vanilla'>{{vanilla}}</a></h1><h5>{{zhoujing}}</h5> </body> </html>