OpenResty从入门到实战
温铭
OpenResty软件基金会主席,《OpenResty 最佳实践》作者
立即订阅
4332 人已学习
课程目录
已完结 52 讲
0/4登录后,你可以任选4讲全文学习。
开篇词 (1讲)
开篇词 | OpenResty,为你打开高性能开发的大门
免费
入门篇 (14讲)
01 | 初探OpenResty的三大特性
02 | 如何写出你的“hello world”?
03 | 揪出隐藏在背后的那些子项目
04 | 如何管理第三方包?从包管理工具luarocks和opm说起
05 | [视频]opm项目导读
06 | OpenResty 中用到的 NGINX 知识
07 | 带你快速上手 Lua
08 | LuaJIT分支和标准Lua有什么不同?
09 | 为什么 lua-resty-core 性能更高一些?
10 | JIT编译器的死穴:为什么要避免使用 NYI ?
11 | 剖析Lua唯一的数据结构table和metatable特性
12 | 高手秘诀:识别Lua的独有概念和坑
13 | [视频]实战:基于FFI实现的lua-resty-lrucache
14 | 答疑(一):Lua 规则和 NGINX 配置文件产生冲突怎么办?
API篇 (11讲)
15 | OpenResty 和别的开发平台有什么不同?
16 | 秒杀大多数开发问题的两个利器:文档和测试案例
17 | 为什么能成为更好的Web服务器?动态处理请求和响应是关键
18 | worker间的通信法宝:最重要的数据结构之shared dict
19 | OpenResty 的核心和精髓:cosocket
20 | 超越 Web 服务器:特权进程和定时任务
21 | 带你玩转时间、正则表达式等常用API
22 | [视频]从一个安全漏洞说起,探寻API性能和安全的平衡
23 | [视频]导读lua-resty-requests:优秀的lua-resty-*是如何编写的?
24 | 实战:处理四层流量,实现Memcached Server
25 | 答疑(二):特权进程的权限到底是什么?
测试篇 (5讲)
26 | 代码贡献者的拦路虎:test::nginx 简介
27 | test::nginx 包罗万象的测试方法
28 | test::nginx 还可以这样用?
29 | 最容易失准的性能测试?你需要压测工具界的“悍马”wrk
30 | 答疑(三)如何搭建测试的网络结构?
性能优化篇 (16讲)
31 | 性能下降10倍的真凶:阻塞函数
32 | 让人又恨又爱的字符串操作
33 | 性能提升10倍的秘诀:必须用好 table
34 | 特别放送:OpenResty编码指南
35 | [视频]实际项目中的性能优化:ingress-nginx中的几个PR解读
36 | 盘点OpenResty的各种调试手段
37 | systemtap-toolkit和stapxx:如何用数据搞定“疑难杂症”?
38 | [视频]巧用wrk和火焰图,科学定位性能瓶颈
39 | 高性能的关键:shared dict 缓存和 lru 缓存
40 | 缓存与风暴并存,谁说缓存风暴不可避免?
41 | lua-resty-* 封装,让你远离多级缓存之痛
42 | 如何应对突发流量:漏桶和令牌桶的概念
43 | 灵活实现动态限流限速,其实没有那么难
44 | OpenResty 的杀手锏:动态
45 | 不得不提的能力外延:OpenResty常用的第三方库
46 | 答疑(四):共享字典的缓存是必须的吗?
API网关篇 (4讲)
47 | 微服务API网关搭建三步曲(一)
48 | 微服务API网关搭建三步曲(二)
49 | 微服务API网关搭建三步曲(三)
50 | 答疑(五):如何在工作中引入 OpenResty?
结束语 (1讲)
结束语 | 行百里者半九十
OpenResty从入门到实战
登录|注册

16 | 秒杀大多数开发问题的两个利器:文档和测试案例

温铭 2019-07-01
你好,我是温铭。在学习了 OpenResty 的原理和几个重要概念后,我们终于要开始 API 的学习了。
从我个人的经验来看,学习 OpenResty 的 API 是相对容易的,所以并没有占用本专栏太多的篇幅。你可以会疑惑:API 不是最常用、最重要的部分吗,为什么花的笔墨不多?
其实,这主要是出于两个方面的考虑。
第一,OpenResty 提供了非常详尽的文档。和很多其他的开发语言或者平台相比,OpenResty 除了会提供 API 的参数、返回值定义,还会提供完整的、可运行的代码示例,清楚地告诉你 API 是如何处理各种边界条件的。
这种在 API 定义下面紧跟着示例代码和注意事项的做法,就是 OpenResty 文档的一贯风格。这样一来,在看完 API 描述后,你就可以立即在自己的环境下运行示例代码,并修改参数来和文档互相印证,加深记忆和理解。
第二,在文档之外,OpenResty 还提供了高覆盖度的测试案例集。刚刚我提到过,OpenResty 文档中提供了 API 的代码示例,但终究篇幅有限,多个 API 之间如何配合使用、各种异常情况下的报错和处理等,在文档中并没有呈现。
不过,不用担心,这些内容你大都可以在测试案例集里找到。
对于 OpenResty 的开发者来说,最好的 API 学习资料就是官方文档和测试案例,它们足够专业和友好。在这个前提下,如果我单纯地把文档翻译成中文再放在专栏中来讲,就没有太大意义了。
取消
完成
0/1000字
划线
笔记
复制
© 版权归极客邦科技所有,未经许可不得传播售卖。 页面已增加防盗追踪,如有侵权极客邦将依法追究其法律责任。
该试读文章来自付费专栏《OpenResty从入门到实战》,如需阅读全部文章,
请订阅文章所属专栏。
立即订阅
登录 后留言

精选留言(11)

  • helloworld
    驱动测试案例:
    1. 安装相关模块
    sudo yum install cpan -y
    sudo cpan YAML
    sudo cpan Test::Nginx

    2. test 测试案例
    git clone git@github.com:openresty/lua-nginx-module.git
    cd lua-nginx-module/
    prove t/043-shdict.t
    2019-07-02
    9
  • helloworld
    老师,指出文章中可能的一处错误:"哪些阶段不能使用共享内存相关的 API?" 这个例子举的貌似不太对。
    restydoc -s ngx.shared 可知共享内存的相关API是支持init_by_lua和init_worker_by_lua阶段的,你在043-shdict.t的第一个测试案例中将content_by_lua修改为init_by_lua,执行测试报错,说明的是init_by_lua指令不能在location里,而不是说明共享内存API的问题。通过restydoc -s init_by_lua 查看,可知,init_by_lua指令的上下文只能是http。

    作者回复: 是的,确实写错了,抱歉,我去修改下。多谢指正。

    2019-07-02
    5
  • 回家
    温铭老师,你好~
    看了https://openresty.gitbooks.io/programming-openresty/content/testing里面的test-nginx文档。今天看到的部分有一个疑问,在RunningTest一节讲一个test file里的test block默认是shuffle方式随机运行的,以便在不同的执行顺序下可能出现的bug被遗漏。然后在PreparingTest一节里讲到,每个test block都会生成一个nginx.conf,生成nginx进程执行,执行下一个test block时,会关闭之前进程,重新启动新的进程。这样打乱test block和不打乱不就没有什么区别了吗?

    作者回复: 这是个好问题,我和你的感觉是一样的。我在自己的项目中都是用 no_shuffle,严格按照顺序来执行。
    这是因为测试案例可能会依赖外部的持久化存储,比如 redis、memcached、postgres 等,那么这个时候随机运行测试就可能出错。
    所以,我也不太理解为什么默认要用shuffle的方式运行。
    我能想到的一个原因,可能是在把 TEST_NGINX_FORCE_RESTART_ON_TEST 设置为 0 的时候,也就是在配置文件不变化的时候不重启 nginx,这个时候随机就有意义了。
    另外,如果TEST_NGINX_FORCE_RESTART_ON_TEST设置为 0, 并且 TEST_NGINX_BENCHMARK 设置为 1,那么就会在不重启和大压力的情况下去做随机测试。
    test::nginx 有很多种组合的模式,我觉得有些设计的过于灵活和复杂了,个人见解,欢迎交流。
    补充一句哈,还有 TEST_NGINX_USE_HUP 这个环境变量,可以保证测试案例间的 shared dict 不被清空。

    2019-07-02
    1
    2
  • 张仕华
    赞赞赞
    2019-07-01
    1
  • fly
    resty --shdict 'dogs 10m' -e 'local dogs = ngx.shared.dogs dogs:get({}) '
    在我的 nginx version: openresty/1.15.8.1 中,并没有出现报错。
    请问老师,这是新版本 get 函数支持 key 的类型为数组了?还是我遗漏了什么?还望老师能指点迷津。
    2019-12-02
  • Jeff.Smile
    呦呦切克闹
    2019-07-04
  • 😑
    温老师,如果多个worker并发存数据,是不是需要加锁,例如这样
    resty --shdict 'dogs 10m' -e 'local dogs = ngx.shared.dogs
    local lock= ngx.xxxx.lock
    lock.lock()
     dogs:set("Jim", 8)
    lock.unlock()
     local v = dogs:get("Jim")
     ngx.say(v)
     '
    那么以后的课程中会讲解到op的锁吗?出现死锁怎么处理呢?

    作者回复: 不用自己加锁哈,shared dict 的操作都是原子性的,这种类似加锁的处理已经帮你考虑到了。

    2019-07-02
    1
  • 风翱
    lua_shared_dict dogs 10m; 这一句应该放在哪里呢?按文中描述,放在www/conf/nginx.conf,通过http://www.chrono.com/demo访问,出现错误提示:2019/07/02 11:16:12 [error] 11184#3284: *3 lua entry thread aborted: runtime error: content_by_lua(http.conf:32):2: attempt to index global 'dogs' (a nil value)
    stack traceback:
    coroutine 0:
    content_by_lua(http.conf:32): in main chunk, client: 127.0.0.1, server: localhost, request: "GET /demo HTTP/1.1", host: "www.chrono.com"

    作者回复: lua_shared_dict dogs 10m 放在 nginx.conf 中是对的。你在代码中是如何引用 dogs 这个共享字典的呢?

    2019-07-02
    2
  • 回家
    通常通过本地调试、文档、网上搜索、邮件列表这些方式解决~
    2019-07-02
  • 刘丹
    请问OpenResty的测试环境要怎样搭建?运行prove t1.t 命令出错:
    t1.t .. Can't locate Test/Nginx/Socket/Lua.pm in @INC (@INC contains: /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 .) at t1.t line 2.
    BEGIN failed--compilation aborted at t1.t line 2.
    t1.t .. Dubious, test returned 2 (wstat 512, 0x200)
    No subtests run

    Test Summary Report
    -------------------
    t1.t (Wstat: 512 Tests: 0 Failed: 0)
      Non-zero exit status: 2
      Parse errors: No plan found in TAP output
    Files=1, Tests=0, 0 wallclock secs ( 0.02 usr + 0.00 sys = 0.02 CPU)
    Result: FAIL
    2019-07-01
    3
  • manatee
    想请问一下老师讲openresty的官方文档是指哪里的内容呢?是github中每个模块readme的部分吗

    作者回复: 是的

    2019-07-01
收起评论
11
返回
顶部