OmniWeb

LUA WEB服务器

特性

1. 小而快将是本软件的始终目标
2. 集成GNU libmicrohttpd(0.9.59), LuaJIT(2.1.0b3), lua-CJson, lua-resty-template, tinyxml2
3. 支持定时器和每日定时任务

示例项目

Team - 轻量级项目任务管理系统 Team 2.0之后使用Go重写了！！！如需查看使用方法，请切换到Team 1.x版本

配置说明

配置文件omni.ini：

; 基本配置
[main]
port=80									; HTTP监听端口，默认80
expire=900000							; Storage存储数据的默认过期时间（毫秒），默认15分
verbose=no								; 是否显示详细访问日志(yes|no)，默认no
use_session=yes							; 是否启用session, 默认no
#script_entry=script/app.lua			; 入口文件
#scheduler_script=scripts/scheduler.lua	; 时间计划加载脚本，不设置时不启用时间计划

; 自定义错误页，只支持静态页面
[error_pages]
#404=scripts/view/404.html
#405=scripts/view/405.html

; 可下载文件目录列表，alias=path
[shared_dirs]
#upload=uploads ; 访问/upload/1.txt指向./uploads/1.txt
#some=E:\1		; 访问/some/1.txt指向E:\1\1.txt

; 其他自定义配置

[注] 配置文件的内容会写Lua全局Tableconfig中。如config.dirs.controller

部署目录

参考bin目录

somewhere               -- 用户指定文件夹
|
|-- omni/omni.exe       -- 发行版中下载编译好的可执行文件
|-- omni.ini            -- 配置文件
|
|-- www                 -- 静态文件（css，images，fonts，js等）存放目录
|   |-- favicon.ico     -- 网站favicon图标
|   |-- css             -- CSS
|   |-- js              -- JS
|   |-- fonts           -- Fonts
|   |-- images          -- 图片
|
|-- scripts             -- 代码及模板存放目录
    |-- app.lua         -- 必需，路由定义（请求分发）
    |-- controller      -- 控制器
    |-- model           -- 数据模型
    |-- vendor          -- LuaJIT第三方插件（推荐从luapower中找）
    |-- view            -- 视图模板存放

路由说明

1. 支持正则（Posix Regex版）路由

2. 接口

   方法	说明
   router:get(filter, proc)	GET路由
   router:post(filter, proc)	POST路由
   router:any(filter, proc)	无限制路由

3. 示例

-- 主页
router:get('^/$', function(req, rsp)
	custom_router(default_ctrl, default_action, req, rsp);
end);

-- MVC
router:any('^/([A-Za-z][A-Za-z0-9_/]*)/([A-Za-z][A-Za-z0-9_]*)$', function(req, rsp, controller, action)
	custom_router(controller, action, req, rsp);
end);

-- MVC（默认ACTION）
router:any('^/([A-Za-z][A-Za-z0-9_]*)$', function(req, rsp, controller)
	custom_router(controller, default_action, req, rsp);
end);

-- MVC（默认ACTION，多层controller）
router:any('^/([A-Za-z][A-Za-z0-9_/]*)/$', function(req, rsp, controller)
	custom_router(controller, default_action, req, rsp);
end);

Request表（路由处理函数proc的第一个参数）

【注】

上传的文件会在请求结束后自行删除，如需保存，请使用os.cp(from, to)复制到其他目录

Response类（路由处理函数proc的第二个参数）

Session

1. 在omni.ini中配置main.use_session=yes后session才可用
2. session为全局的table，更改后自动保存
3. 清空session只需要执行session = {}

视图

1. 语法请自行参考lua-resty-template。
2. 渲染调用接口为rsp:html(view, data, is_plain)。

全局存储

使用string => string的key-value存储
由于每个HTTP会话使用独立的Lua VM，因此需要存放的全局数据，请使用storage

时间计划

支持全局定时器和每日时间计划。使用方法示例：

1. 在配置文件中声明时间计划脚本

[main]
scheduler_script=scripts/scheduler.lua

2. 编写时间计划

-- scripts/scheduler.lua文件内容

-- 开启一个每天12点执行的任务
scheduler.daily(12, 0, 0, function()
	local users = require(config.dirs.model .. 'user');
	local find = users:query[[SELECT * FROM `users`]];
	...
end);

-- 开启一个每隔12秒执行的任务
scheduler.timer(12000, function()
	print('hehe')
end, true);

时间计划的接口

Lua层的C++接口

扩展os库

全局函数

JSON

XML

BASE64

LOGGER