OpenResty完全开发指南:构建百万级别并发的Web应用
上QQ阅读APP看本书,新人免费读10天
设备和账号都新为新人

1.10 参考手册

OpenResty附带了非常完善的用户参考手册restydoc,提供与UNIX手册man相同的功能,可以检索OpenResty里所有组件的帮助文档,包括但不限于:

    ■  OpenResty各个组件的介绍和用法;
    ■  OpenResty指令和功能接口的用法;
    ■  Nginx介绍、用法、基本工作原理;
    ■  Lua/LuaJIT语法要素。

下面示范了一些restydoc的用法,其中的“-s”参数用来指定搜索手册里的小节名:

restydoc nginx                                #Nginx的说明
restydoc luajit                               #LuaJIT的说明
restydoc opm                                  #包管理工具opm的说明
restydoc resty-cli                            #命令行工具resty的说明
restydoc ngx_echo                             #ngx_echo组件的说明
restydoc ngx_lua                              #ngx_lua的说明
restydoc stream_lua                           #stream_lua的说明
restydoc lua-cjson                            #lua-cjson的说明
restydoc -s proxy_pass                        #反向代理指令proxy_pass的说明
restydoc -s content_by_lua_block              #content_by_lua_block指令的说明
restydoc -s ngx.say                           #功能接口ngx.say的说明
restydoc -s concat                            #Lua函数concat的说明

对于使用opm安装的组件,需要使用“-r”参数指定安装目录,例如:

restydoc -r /usr/local/openresty/site -s lua-resty-http

多使用restydoc可以帮助我们尽快熟悉OpenResty开发。