×
关于Socket 编程发展OpenResty 简介Lua 入门Lua 简介Lua 环境搭建基础数据类型表达式控制结构if/elsewhilerepeatforbreak,returnLua函数函数的定义函数的参数函数返回值全动态函数调用模块String 库Table 库日期时间函数数学库函数文件操作

Lua 高阶

元表面向对象编程局部变量判断数组大小非空判断正则表达式不用标准库虚变量抵制使用 module() 定义模块调用代码前先定义函数点号与冒号操作符的区别module 是邪恶的FFI什么是 JITNginxNginx 新手起步location 匹配规则if 是邪恶的静态文件服务日志反向代理负载均衡陷阱和常见错误

OpenResty

环境搭建Windows 平台CentOS 平台Ubuntu 平台Mac OS X 平台Hello World与其他 location 配合获取 uri 参数获取请求 body输出响应体日志输出简单API Server框架使用 Nginx 内置绑定变量子查询不同阶段共享变量防止 SQL 注入如何发起新 HTTP 请求

LuaRestyRedisLibrary

访问有授权验证的 Redisselect+set_keepalive 组合操作引起的数据读写错误redis 接口的二次封装(简化建连、拆连等细节)redis 接口的二次封装(发布订阅)pipeline 压缩请求数量script 压缩复杂请求动态生成的 lua-resty-redis 模块方法LuaCjsonLibraryjson解析的异常捕获稀疏数组空table编码为array还是objectPostgresNginxModule调用方式简介不支持事务超时健康监测SQL注入LuaNginxModule执行阶段概念正确的记录日志热装载代码阻塞操作缓存sleep定时任务禁止某些终端访问请求返回后继续执行调试请求中断后的处理我的 lua 代码需要调优么变量的共享范围动态限速shared.dict 非队列性质正确使用长链接如何引用第三方 resty 库body 在 location 中的传递典型应用场景怎样理解 cosocket如何安全启动唯一实例的 timer如何正确的解析域名使用动态 DNS 来完成 HTTP 请求LuaRestyLock缓存失效风暴

stream_lua_module

balancer_by_lua

OpenResty 与 SSL

HTTPS 时代动态加载证书和 OCSP staplingTLS session resumption测试代码静态分析单元测试代码覆盖率API 测试性能测试持续集成灰度发布Web 服务API的设计数据合法性检测协议无痛升级代码规范连接池C10K 编程TIME_WAIT 问题与 Docker 使用的网络瓶颈火焰图什么时候使用如何定位问题

OpenResty 周边

如何添加自己的lua api

零碎知识点记录

2016-7 月汇总如何在后台开启轻量级线程来定时更新共享内存一个 openresty 内存“泄漏”问题用 do-end 整理你的代码lua 中如何 continue调用 FFI 出现 "table overflow"如何定位 openresty 崩溃 bug

代码覆盖率


这是一个重要的可量化指标,如果代码覆盖率很高,你就可以放心的修改代码,在发版本的时候也能睡个安稳觉。否则就是拆东墙补西墙,陷入无尽的 bug 诅咒中。

那么在 OpenResty 里面如何看到代码覆盖率呢?其实很简单,使用 LuaCov 可以很方便的实现。

我们先了解下 LuaCov,这是一个针对 Lua 脚本的代码覆盖率工具,通过 luarocks 来安装:

luarocks install luacov

当然,你也可以通过 GitHub 上的源码 编译来安装。这个方式你可以修改 LuaCov 的一些默认配置。

比如 LuaCov 的分析文件是按照 100 条一批来写入的,如果你的代码量不大,可能就会不准确。你可以修改 /src/luacov/defaults.Lua 里面的 savestepsize,改为 2 ,来适应你的应用场景。

在 OpenResty 里面使用 LuaCov,只用在 Nginx.conf 中增加 init_by_lua_block(只能放在 http 上下文中)既可。

init_by_lua_block {
    require 'luacov.tick'
    jit.off()
}

这个 *_bolck 语法在较新的 OpenResty 版本中新引入,如果提示指令不存在,请使用最新的来版本来测试。

重新启动 OpenResty 后,LuaCov 就已经生效了。你可以跑下单元测试,或者访问下 API 接口,在当前工作目录下,就会生成 luacov.stats.out 这个统计文件。然后 cd 到这个目录下,运行:

luacov

就会生成 luacov.report.out 这个可读性比较好的覆盖率报告。需要注意的是,luacov 这个命令后面不用加任何的参数,这个在官方文档里面有说明,只是比较隐晦。

我们看下 luacov.report.out 里面的一个片段:

1   function get_config(mid, args)
13    local configs = {}
13    local res, err = red:hmget("client_".. mid, "tpl_id", "gid")
13    if err then
****0     return nil, err
        end
      end

代码前面的数字,代表的是运行的次数。而 ****0 很明确的指出这行代码没有被测试案例覆盖到。

luacov.report.out 的最后会有一个汇总的覆盖率报告:

覆盖率报告

可以看到,在我的这个单元测试里面,一共涉及到近 20 个代码文件。其中倒数第三个是我测试的 API 接口,覆盖到的代码有 19 行,没有覆盖的有 3 行,所以代码覆盖率是 86.36%(19.0 / (19 + 3))。

最后有一个总的代码覆盖率是 28.3%,这个值在跑完所有单元测试后是有意义的,单跑一个是没有参考价值的,因为很多基础函数可能并没有运行到。


分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)