当前位置: 首页 > 文档资料 > Vanilla 中文手册 >

ChangeLogs - vanilla-0.1.0.rc3

优质
小牛编辑
128浏览
2023-12-01

安装

目前Vanilla支持两种安装方式

  • Make(推荐使用此种)
  • Luarocks(已有 OpenResty 环境 Luarocks 的安装可以参考《基于 OpenResty 安装 Luarocks》)

make install安装须知

Vanilla 支持的选项都提供了默认值,如果你的环境与默认值不一样,请configure时指定成你自己的。

特别注意选项--openresty-path,默认为/usr/local/openresty,请确保设置正确。

可以在源码目录下执行configure --help来查看安装选项的使用方法。

下面是一个简单的安装示例:

  1. ./configure --prefix=/usr/local/vanilla --openresty-path=/usr/local/openresty
  2. make install (如果没有C模块【目前支持lua-filesystem】,则不需要make,直接make install)

luarocks install安装须知

可以使用luarocks安装vanilla,但是下面三点请注意

  1. Luarocks应该基于lua5.1.x的版本安装,因为其他版本Lua和Luajit的ABI存在兼容性问题。
  2. Luarocks安装的Vanilla在nginx.conf文件的NGX_PATH变量不可用。
  3. 请确保nginx命令可以直接运行(nginx命令在你的环境变量中)

Vanilla 使用

Vanilla命令

Vanilla 目前提供了两个命令 vanilla,和 vanilla-console

  • vanilla用来初始化应用骨架,停启服务(添加—trace参数可以看到执行的命令)
  • vanilla-console 是一个交互式命令行,主要提供一种方便学习Lua入门的工具,可以使用一些vanilla开发环境下的包,比如table输出的lprint_r方法。

命令行执行 vanilla就能清晰看到 vanilla命令提供的选项。

  1. vanilla
  2. Vanilla v0.1.0-rc3, A MVC web framework for Lua powered by OpenResty.
  3. Usage: vanilla COMMAND [ARGS] [OPTIONS]
  4. The available vanilla commands are:
  5. new [name] Create a new Vanilla application
  6. start Starts the Vanilla server
  7. stop Stops the Vanilla server
  8. Options:
  9. --trace Shows additional logs

创建应用

  1. vanilla new app_name
  2. cd app_name
  3. vanilla start [--trace] -- 默认运行在development环境
  4. ## 在linux的bash环境下:
  5. VA_ENV=production vanilla start [--trace] -- 运行在生产环境
  6. ## 在BSD等tcsh环境下:
  7. setenv VA_ENV production;vanilla start [--trace] -- 运行在生产环境

代码目录结构

  1.  /Users/zj-git/app_name/ tree ./
  2. ./
  3. ├── application(应用代码主体目录)
  4. │ ├── bootstrap.lua(应用初始化 / 可选<以下未标可选为必选>)
  5. │ ├── controllers(应用业务代码主体目录)
  6. │ │ ├── error.lua(应用业务错误处理,处理本路径下相应业务报错)
  7. │ │ └── index.lua(hello world示例)
  8. │ ├── library(应用本地类包)
  9. │ ├── models(应用数据处理类)
  10. │ │ ├── dao(数据层业务处理)
  11. │ │ │ └── table.lua
  12. │ │ └── service(服务化业务处理,对DAO的再次封装)
  13. │ │ └── user.lua
  14. │ ├── nginx(*Openresty所封装Nginx请求处理各Phase)
  15. │ │ └── init.lua(*init_by_lua示例)
  16. │ ├── plugins(插件目录)
  17. │ └── views(视图层,与controllers一一对应)
  18. │ ├── error(错误模板)
  19. │ │ └── error.html
  20. │ └── index(index controller模板)
  21. │ └── index.html
  22. ├── config(应用配置目录)
  23. │ ├── application.lua(应用基础配置 / 路由器、初始化等设置)
  24. │ ├── errors.lua(应用错误信息配置)
  25. │ ├── nginx.conf(nginx配置文件模板)
  26. │ ├── nginx.lua(服务各种运行环境配置 / 是否开启lua_code_cache等)
  27. │ ├── waf-regs(应用防火墙规则配置目录)
  28. │ │ ├── args
  29. │ │ ├── cookie
  30. │ │ ├── post
  31. │ │ ├── url
  32. │ │ ├── user-agent
  33. │ │ └── whiteurl
  34. │ └── waf.lua(服务防火墙配置)
  35. ├── logs(日志目录)
  36. │ └── hack(攻击日志目录 / 保持可写权限)
  37. ├── pub(应用Nginx配置根路径)
  38. └── index.lua(应用请求入口)

业务代码示例 IndexController

  1. local IndexController = {}
  2. function IndexController:index()
  3. local view = self:getView()
  4. local p = {}
  5. p['vanilla'] = 'Welcome To Vanilla...'
  6. p['zhoujing'] = 'Power by Openresty'
  7. view:assign(p)
  8. return view:display()
  9. end
  10. return IndexController

模板示例 views/index/index.html

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

为什么需要Vanilla

回答这个问题,我们只需要看清楚Openresty和Vanilla各自做了什么即可。

Openresty

  • 提供了处理HTTP请求的全套整体解决方案
  • 给Nginx模块开发开辟了一条全新的道路,我们可以使用Lua来处理Web请求
  • 形成了一个日趋完善的生态,这个生态涵盖了高性能Web服务方方面面

Vanilla

  • 使复杂的Nginx配置对Web业务开发者更透明化
  • 开发者不再需要了解Openresty的实现细节,而更关注业务本身
  • 实现了Web开发常规的调试,错误处理,异常捕获
  • 实现了请求的完整处理流程和插件机制,支持路由协议、模板引擎的配置化
  • 整合、封装了一系列Web开发常用的工具集、类库(cookie、应用防火墙等)
  • 实现了自动化、配置化的Nginx指令集管理
  • 更合理的利用Openresty封装的8个处理请求Phase
  • 支持不同运行环境(开发、测试、上线)服务的自动化配置和运行管理
  • 功能使用方便易于扩展
  • 基于Openresty开发,具备Openresty一切优良特性