登录  /  注册

nginx lua模块常用的指令

PHP中文网
发布: 2016-08-08 09:31:48
原创
1273人浏览过

lua_code_cache

语法:lua_code_cache on | off

默认: on

适用上下文:http、server、location、location if

这个指令是指定是否开启lua的代码编译缓存,开发时可以设置为off,以便lua文件实时生效,如果是生产线上,为了性能,建议开启。

lua_package_path

语法:lua_package_path

默认:由lua的环境变量决定

适用上下文:http

设置lua代码的寻找目录。

例如:lua_package_path "/opt/nginx/conf/www/?.lua;;";

具体的路径设置要参考lua的模块机制

init_by_lua(_file)

语法:init_by_lua

适用上下文:http

 init_by_lua 'cjson = require "cjson"'; server{location= /api {content_by_lua '
                ngx.say(cjson.encode({dog = 5, cat = 6}))
            ';}}
登录后复制

从这段配置代码,我们可以看出,其实这个指令就是初始化一些lua的全局变量,以便后续的代码使用。

注:有(_file)的选项代表可以直接引用外部的lua源代码文件,效果与直接写配置文件一样,不过可维护性当然是分开好点。

init_worker_by_lua(_file)

类似于上面的,不过是作用在work进程的,先于work进程启动而调用。

set_by_lua(_file)

语法:set_by_lua $res

适用上下文:server、location、location if

location /foo {set$diff'';# we have to predefine the $diff variable here 
        set_by_lua $sum'
            local a = 32
            local b = 56
 
            ngx.var.diff = a - b;  -- write to $diff directly
            return a + b;          -- return the $sum value normally
        ';echo "sum = $sum, diff = $diff";}
登录后复制

这个指令是为了能够让nginx的变量与lua的变量相互作用赋值。

content_by_lua(_file)

语法:content_by_lua

适用上下文:location、location if

location /nginx_var {# MIME type determined by default_type:default_type'text/plain'; 
# try access /nginx_var?a=hello,worldcontent_by_lua "ngx.print(ngx.var['arg_a'], '\\n')";}
登录后复制

通过这个指令,可以由lua直接确定nginx响应页面的正文。

rewrite_by_lua(_file)

语法:rewrite_by_lua 

适用上下文:location、location if

这个指令更多的是为了替代HttpRewriteModule的rewrite指令来使用的,优先级低于rewrite指令

比如

location /foo {
          set$a12;# create and initialize $a
          set$b'';# create and initialize $b
          rewrite_by_lua 'ngx.var.b = tonumber(ngx.var.a) + 1';
          if($b='13'){
             rewrite ^ /bar redirect;
             break;
          }
    
         echo "res = $b";
    }
登录后复制

这个并不会像预期的那样子,因为我猜测,rewrite_by_lua是开启一个协程去工作的,可是下面却继续执行下去了,所以得不到预期的结果。

此时如果由lua代码来控制rewrite,那就没有问题了。

location /foo {set$a12;# create and initialize $aset$b'';# create and initialize $brewrite_by_lua '
            ngx.var.b = tonumber(ngx.var.a) + 1
            if tonumber(ngx.var.b) == 13 then
                return ngx.redirect("/bar");
            end
        '; 
        echo "res = $b";}
登录后复制

access_by_lua(_lua)

语法:access_by_lua 

适用上下文:http, server, location, location if

location / {deny    192.168.1.1;allow   192.168.1.0/24;allow   10.1.1.0/16;deny    all; 
        access_by_lua '
            local res = ngx.location.capture("/mysql", { ... })
            ...
        '; # proxy_pass/fastcgi_pass/...}
登录后复制

顾名思义,这个指令用在验证通过或者需要验证的时候。

header_filter_by_lua(_file)

语法:header_filter_by_lua

适用上下文:http, server, location, location if

location / {proxy_passhttp://mybackend;header_filter_by_lua 'ngx.header.Foo = "blah"';}
登录后复制

用lua的代码去指定http响应的 header一些内容。

body_filter_by_lua(_file)

语法:body_filter_by_lua

适用上下文:http, server, location, location if

location /t {echo hello world;echo hiya globe; 
        body_filter_by_lua '
            local chunk = ngx.arg[1]
            if string.match(chunk, "hello") then
                ngx.arg[2] = true  -- new eof
                return
            end
 
            -- just throw away any remaining chunk data
            ngx.arg[1] = nil
        ';}
登录后复制

这个指令可以用来篡改http的响应正文的。

以上就介绍了nginx lua模块常用的指令,包括了方面的内容,更多相关内容请关注PHP中文网(www.php.cn)!

智能AI问答
PHP中文网智能助手能迅速回答你的编程问题,提供实时的代码和解决方案,帮助你解决各种难题。不仅如此,它还能提供编程资源和学习指导,帮助你快速提升编程技能。无论你是初学者还是专业人士,AI智能助手都能成为你的可靠助手,助力你在编程领域取得更大的成就。
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
作者最新文章
最新问题
关于CSS思维导图的课件在哪? 课件
凡人来自于2024-04-16 10:10:18
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2024 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号