Skip to content

Latest commit

 

History

History
144 lines (105 loc) · 7.19 KB

basic.md

File metadata and controls

144 lines (105 loc) · 7.19 KB

OpenResty基础

  • OpenResty版本号
    • OpenResty 的版本号是跟着它所使用的 Nginx 来确定的,比如 OpenResty 的 1.15.8.1,使用的 Nginx 版本号就是 1.15.8,最后的 1 是 OpenResty 自己的小版本号
  • 启动与关闭
    • 指定配置文件

        $ openresty -p `pwd` -c conf/nginx.conf
      
    • 关闭

        $ openresty -s stop
      
    • 重启

        $ openresty -s reload
      
  • 查看openresty版本信息和编译参数
$ openresty -v
nginx version: openresty/1.15.8.1
$ openresty -V
nginx version: openresty/1.15.8.1
built by clang 8.0.0 (clang-800.0.42.1)
built with OpenSSL 1.1.0j  20 Nov 2018
TLS SNI support enabled
configure arguments: --prefix=/usr/local/Homebrew/Cellar/openresty/1.15.8.1/nginx --with-cc-opt='-O2 -I/usr/local/Homebrew/include -I/usr/local/Homebrew/opt/pcre/include -I/usr/local/Homebrew/opt/openresty-openssl/include' --add-module=../ngx_devel_kit-0.3.1rc1 --add-module=../echo-nginx-module-0.61 --add-module=../xss-nginx-module-0.06 --add-module=../ngx_coolkit-0.2 --add-module=../set-misc-nginx-module-0.32 --add-module=../form-input-nginx-module-0.12 --add-module=../encrypted-session-nginx-module-0.08 --add-module=../srcache-nginx-module-0.31 --add-module=../ngx_lua-0.10.15 --add-module=../ngx_lua_upstream-0.07 --add-module=../headers-more-nginx-module-0.33 --add-module=../array-var-nginx-module-0.05 --add-module=../memc-nginx-module-0.19 --add-module=../redis2-nginx-module-0.15 --add-module=../redis-nginx-module-0.3.7 --add-module=../ngx_stream_lua-0.0.7 --with-ld-opt='-Wl,-rpath,/usr/local/Homebrew/Cellar/openresty/1.15.8.1/luajit/lib -L/usr/local/Homebrew/lib -L/usr/local/Homebrew/opt/pcre/lib -L/usr/local/Homebrew/opt/openresty-openssl/lib' --pid-path=/usr/local/Homebrew/var/run/openresty.pid --lock-path=/usr/local/Homebrew/var/run/openresty.lock --conf-path=/usr/local/Homebrew/etc/openresty/nginx.conf --http-log-path=/usr/local/Homebrew/var/log/nginx/access.log --error-log-path=/usr/local/Homebrew/var/log/nginx/error.log --with-pcre-jit --with-ipv6 --with-stream --with-stream_ssl_module --with-stream_ssl_preread_module --with-http_v2_module --without-mail_pop3_module --without-mail_imap_module --without-mail_smtp_module --with-http_stub_status_module --with-http_realip_module --with-http_addition_module --with-http_auth_request_module --with-http_secure_link_module --with-http_random_index_module --with-http_geoip_module --with-http_gzip_static_module --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-threads --with-dtrace-probes --with-stream --with-stream_ssl_preread_module --with-http_ssl_module
  • openresty命令帮助
$ openresty -h
nginx version: openresty/1.15.8.1
Usage: nginx [-?hvVtTq] [-s signal] [-c filename] [-p prefix] [-g directives]

Options:
  -?,-h         : this help
  -v            : show version and exit
  -V            : show version and configure options then exit
  -t            : test configuration and exit
  -T            : test configuration, dump it and exit
  -q            : suppress non-error messages during configuration testing
  -s signal     : send signal to a master process: stop, quit, reopen, reload
  -p prefix     : set prefix path (default: /usr/local/Homebrew/Cellar/openresty/1.15.8.1/nginx/)
  -c filename   : set configuration file (default: /usr/local/Homebrew/etc/openresty/nginx.conf)
  -g directives : set global directives out of configuration file

PS:可以看到默认加载的配置文件位置

  • restydoc 帮助查看命令
$ restydoc -s ngx.say
ngx_lua-0.10.15(7)              ngx_lua-0.10.15             ngx_lua-0.10.15(7)

   ngx.say
       syntax: ok, err = ngx.say(...)

       context: rewrite_by_lua*, access_by_lua*, content_by_lua*

       Just as ngx.print but also emit a trailing newline.



OpenResty                         2019-06-02                ngx_lua-0.10.15(7)
(END)
  • OpenResty 的 CLI:resty

      $ which resty
      /usr/local/Homebrew/bin/resty
      $ resty -e "ngx.say('hello world')"
      hello world
      $ resty -h
      resty [options] [lua-file [args]]
    
      Options:
          -c NUM              Set maximal connection count (default: 64).
          -e PROG             Run the inlined Lua code in "prog".
    
          --errlog-level LEVEL
                              Set nginx error_log level.
                              Can be debug, info, notice, warn, error, crit, alert,
                              or emerg.
    
          --gdb               Use GDB to run the underlying nginx C process.
    
          --gdb-opts OPTS     Pass extra command-line options to GDB.
    
          --help              Print this help.
    
          --http-conf CONF    Specifies nginx.conf snippet inserted into the http {}
                              configuration block (multiple instances are supported).
    
          --http-include PATH Include the specified file in the nginx http
                              configuration block (multiple instances are supported).
    
          -I DIR              Add dir to the search paths for Lua libraries.
    
          -j dump             Use LuaJIT's jit.dump module to output detailed info of
                              the traces generated by the JIT compiler.
    
          -j off              Turn off the LuaJIT JIT compiler.
    
          -j v                Use LuaJIT's jit.v module to output brief info of the
                              traces generated by the JIT compiler.
    
          -l LIB              Require library "lib".
    
          --main-conf CONF    Specifies nginx.conf snippet inserted into the nginx
                              main {} configuration block (multiple instances are
                              supported).
    
          --main-include PATH Include the specified file in the nginx main
                              configuration block (multiple instances are supported).
    
          --nginx             Specify the nginx path (this option might be removed
                              in the future).
    
          --ns IP             Specify a custom name server (multiple instances are
                              supported).
    
          --resolve-ipv6      Make the nginx resolver lookup both IPv4 and IPv6
                              addresses.
    
          --rr                Use Mozilla rr to record the execution of the
                              underlying nginx C process.
    
          --shdict 'NAME SIZE'
                              Create the specified lua shared dicts in the http
                              configuration block (multiple instances are supported).
    
          --stap
                              Use sysetmtap to run the underlying nginx C process.
    
          --stap-opts OPTS
                              Pass extra systemtap command line options.
    
          -V                  Print version numbers and nginx configurations.
    
          --valgrind          Use valgrind to run nginx.
    
          --valgrind-opts OPTS
                              Pass extra options to valgrind.
    
      For bug reporting instructions, please see:
    
          <https://openresty.org/en/community.html>
    
      Copyright (C) Yichun Zhang (agentzh). All rights reserved.