一个基于OpenResty的仿Yii的web框架，通过本框架能够极大降低openresty的开发入门门槛。 [English](README.md)

安装OpenResty 1.0以上版本 https://openresty.org/en/download.html

开始，bash中cd到当前目录，执行：runtime/start.sh停止，bash中cd到当前目录，执行：runtime/stop.sh

开始，双击：runtime/win-start.bat停止，双击：runtime/win-stop.bat

目录及文件：|____index.lua                      #入口文件|____lua-releng                     #检查代码质量／是否使用了全局变量|____config                         #配置文件目录| |____db.lua                       #数据库配置| |____lang.lua                     #语言包配置| |____memcache.lua                 #memcache配置| |____session.lua                  #session配置| |____web.lua                      #网站基本信息配置|____controllers                    #controller目录| |____site.lua                     #前端页面|____models                         #models目录| |____LoginForm.lua                #登录逻辑处理类| |____Userinfo.lua                 #用户信息管理类|____runtime                        #Openresty运行目录| |____client_body_temp             #post上传的临时保存目录| |____fastcgi_temp                 #fastcig临时目录| |____logs                         #站点日志目录| | |____access.log                 #请求日志| | |____error.log                  #错误日志| | |____nginx.pid                  #nginx进程文件| |____nginx.conf                   #站点nginx配置文件| |____proxy_temp                   #proxy_temp| |____scgi_temp                    #scgi_temp | |____start.sh                     #站点启动程序| |____stop.sh                      #站点停止程序| |____uwsgi_temp                   #uwsgi_temp|____vendor                         #框架及第三方类| |____ActiveRecord.lua             #数据库处理基类| |____Application.lua              #请求处理类| |____Controller.lua               #Controller基类| |____Files.lua                    #上传文件接收类| |____Memcache.lua                 #Memcache操作类| |____Model.lua                    #Model基类| |____Mysql.lua                    #Mysql操作类| |____Pager.lua                    #分页类| |____Query.lua                    #查询构建器| |____Request.lua                  #请求信息工具类| |____resty                        #第三方resty工具| | |____http.lua                   #http请求工具| | |____template.lua               #lua模版工具类| |____Session.lua                  #Session操作类| |____User.lua                     #用户信息操作类| |____Util.lua                     #基本工具类|____views                          #页面模版目录| |____layout                       #页面框架目录| | |____main.lua.html              #基本站点框架| |____site                         #站点页面目录| | |____error.lua.html             #错误信息页| | |____guide.lua.html             #开发说明页| | |____index.lua.html             #首页| | |____login.lua.html             #登录页|____web                            #静态资源目录| |____css                          #样式| | |____bootstrap-theme.css        #bootstrap| | |____bootstrap-theme.min.css    #bootstrap| | |____bootstrap.css              #bootstrap| | |____bootstrap.min.css          #bootstrap| | |____site.css                   #站点样式| |____js                           #javascript | | |____bootstrap.js               #bootstrap| | |____bootstrap.min.js           #bootstrap| | |____jquery.js                  #jquery| | |____jquery.min.js              #jquery| | |____jquery.slim.js             #jquery| | |____jquery.slim.min.js         #jquery| |____favicon.ico                  #图标| |____robots.txt                   #robots.txt

ngx.ctx = require("vendor.Application"):new()

local _M = require("vendor.Controller"):new{_VERSION='0.01'}    --生成Controller新实例function _M:indexAction()   --动作方法名必须以name+Action组成    if not self.user.isLogin then return self:loginAction() end     --使用用户信息类判断用户是否登录    local Product = require('models.Product')               --使用Product数据表操作类    local query = Product.find().where{'in','product_id',self.user.resource} --fin()方法生成新的查询器    local page = Pager{                 --使用分页类        pageSize = 8,                   --设置每页显示最多8条信息        totalCount = query.count(),     --使用查询器查询符合条件的数据总条数    }    local list = query.orderBy('create_time desc').page(page).all() --使用查询器查询分页数据集        return self:render('index',{        page = page,        list = list,    })endretrun _M

local _M = require("vendor.Model"):new{_version='0.0.1'}    --生成Model新实例local Userinfo = require('models.Userinfo')     --在Model里使用其他modelfunction _M.rules()     --方法rules添加数据校验规则    return {        {{'username','password','sacode'}, 'trim'}, --通过trim自动过滤输入        {'username', 'required',message='请填写登录账号'}, --通过required规则设置必须填写        --{'username', 'email'},            --如果需要用户名必须为email时设置        {'password', 'required',message='请填写登录密码'},        --使用自定义方法校验参数        {'password','checkPass'}        --使用自定义checkPass方法进行校验    }endfunction _M:checkPass(key)    if self:hasErrors() then return end    local user = Userinfo.getUserByName(self.username)    if not user then         self:addError('username','账号不存在')    elseif user.password ~= self.password then        self:addError('password','密码错误')    else        self.userinfo = user    endendfunction _M:login(user)    if not self:validate() then return false end        return user.login(self.userinfo, rememberMe and 3600*24*30 or 0)endreturn _M

--因为Model包含有数据，一定要调用new方法生成新实例，避免出现数据缓存问题local model = require('models.LoginForm'):new() --通过model的load()方法，可自动装载数据if model:load(self.request.post()) and model:login(self.user) then    return self:goHome()end

local _M = require("vendor.Controller"):new{layout = 'manage'}

local request = require("vendor.Request")--在Controller方法里可以直接通过self.request调用local get = request.get()--等价于php: $get = $_GET;local id = request.get('id');   --等价于php: $id = isset($_GET['id']) ? $_GET['id'] : null;local id = request.get('id', 1)   --等价于php: $id = isset($_GET['id']) ? $_GET['id'] : 1;local post = request.post()--等价于php: $post = $_POST;local name = request.post('name')   --等价于php: $name = isset($_POST['name']) ? $_POST['name'] : null;local name = request.post('name', '')   --等价于php: $name = isset($_POST['name']) ? $_POST['name'] : '';local cookie = request.cookie()--等价于php: $cookie = $_COOKIE;local sso = request.cookie('sso')   --等价于php: $sso = isset($_COOKIE['sso']) ? $_COOKIE['sso'] : null;local sso = request.cookie('sso', '')   --等价于php: $sso = isset($_COOKIE['sso']) ? $_COOKIE['sso'] : '';--判断是否有上传文件ngx.say(request.isPostFile())--注意跟php不同的地方，如果有上传文件时，普通参数是无法通过request.post()方法获取到的--建议上传文件时，普通参数通过GET传递--接收上传文件local file = require('vendor.Files')local savename = path..filenamelocal ok,err = file.receive('upfile',savename)  --接收name为upfile的上传文件if not ok  then      return {retcode=1,retmsg='接收文件失败，请重试:'..err}  end

local util = require "vendor.Util"util.set_cookie('abc','123')util.set_cookie('def','456',3600)util.set_cookie(name,value,expire,path,domain,secure,httponly)

ocal session = require "vendor.Session"--在Controller方法里可以直接通过self.session调用--session.start()   --启用session，会去设置一个_sessionid的cookie，此操作可以省略--session.exptime = 1800 --修改session失效时间时，默认30分钟--session.cache = ngx_shared['session_cache'] --默认使用ngx的缓存，对应runtime/nginx.conf里的lua_shared_dict配置项--session.cache = require("vendor.Memcache"):new{host="127.0.0.1",port="11211"} --使用memcached缓存打开此配置local sessions = session.get()--等价于php: $sessions = $_SESSION;local abc = session.get('abc')   --等价于:local abc = session.abc --等价于:local abc = session['abc']--等价于php: $abc = isset($_SESSION['abc']) ? $_SESSION['abc'] : null;local abc = session.get('abc', '')   --等价于php: $abc = isset($_SESSION['abc']) ? $_SESSION['abc'] : '';--设置session值session.set('abc','abc-value')--等价于:session.abc = 'abc-value'--等价于:session['abc'] = 'abc-value'

local db = require('vendor.Mysql'):new{    host = "127.0.0.1",    port = 3306,    database = "mytest",    user = "root",    password = "",    charset = "utf8", --建议配置Mysql的默认连接字符集为utf8，可去掉此配置项，此项配置会增加一次'SET NAMES utf8'的操作}--或者直接通过配置文件获得：local db = require('config.db')--执行sql：local rows = db:query('select * from mytable')ngx.say(#rows)

local db = require('config.db')local query = require('vendor.Query')()local rows = query.use(db).from('products').where({product_id=123}).all()--相当于执行local rows = db:query("select * from products where product_id='123'")ngx.say(query.get('sql')) --能获取到构造出的sql语句--query.use()用于指定链接的数据库query.use(require('config.db'))--query.select()用于指定要查询的字段，不指定默认为select *query.select({'id', 'email'})--等同于：query.select('id, email')--query.from()用于指定要查询的表格 SELECT * FROM `user`query.from('user')

query.orderBy('create_time desc')--等价于：query.orderBy{create_time=desc}

query.groupBy{'id', 'status'}

query.limit(10).offset(20)

local page = require("vendor.Pager"){    pageSize = 8,    totalCount = 10,}query.page(page) --等价于：query.limit(page.limit).offset(page.offset)

local db = require('config.db')local query = require('vendor.Query'){}.use(db).from('products').where{product_id=123}local rows = query.all()local row = query.one()local count = query.count()

local db = require('config.db')local data = {product_id=123,product_name='name123'}local query = require('vendor.Query')(data).use(db).from('products')--插入：local row = query.insert()--要获取新插入的数据的自增长id，请使用：local id = row.get('insert_id') --等价于query.get('insert_id')--更新：row.product_name = 'name456'row.update()    --或者query.update(row)--删除：row.delete()    --或者query.update(row)

local Product = require('vendor.ActiveRecord'){    --db = require('config.db'),    --可选属性，指定使用的数据库连接，未设置时默认使用'config.db'    tableName = function()          --必须实现tableName方法，返回要操作的数据表名称        return 'products'    end}--插入数据：local product = Product.new{    product_id   = 123,    product_name = 'name123',}   --返回的对象支持使用vendor.Query方法product.save()  --等价于product.insert()--快速查找一行local row = Product.findOne{product_id = 123}   --返回的对象支持使用vendor.Query方法--快速查找多行local rows = Product.findAll{user='creater'}    --返回的对象支持使用vendor.Query方法--复杂查询local query = Product.find().where{user='creater'}  --返回的对象支持使用vendor.Query方法local page = Pager{    pageSize = 8,    totalCount = query.count(),}local list = query.orderBy('create_time desc').page(page).all()--同样可以执行以下操作query.insert()  --插入数据。query.update()  --更新数据。query.delete()  --删除数据。

local util = require("vendor.Util")value = util.mescape(value)