在CentOS 6.9 x86_64的nginx 1.12.2上开启echo-nginx-module模块实录

╰半夏微凉° 2022-06-02 05:37 81阅读 0赞

echo-nginx-module是一个第三方模块，在nginx源码中没有，但是OpenResty中有，它为nginx.conf带来了echo，sleep，time等多个类似bash的强大命令。  
目前最新版本是v0.61

安装指南参见  
[https://github.com/openresty/echo-nginx-module\#installation][https_github.com_openresty_echo-nginx-module_installation]  
  
配置

server {
            listen 8081;
            server_name localhost;
    
            location /test {
                set $foo hello;
                echo "foo: $foo";
            }
    
            location /test1 {
                set $first "hello ";
                echo "${first}world";
            }
    
            location /foo {
                echo "foo = [$foo]";
            }
    
            location /bar {
                set $foo 32; 
                echo "bar = [$foo]";
            }
        }

完整的nginx.conf如下：  
[https://github.com/taoyunxing/github\_test/blob/master/nginx.conf  
][https_github.com_taoyunxing_github_test_blob_master_nginx.conf]  
下载源码  
cd /usr/local/src  
git clone https://github.com/openresty/echo-nginx-module.git  
  
cd nginx-1.12.2  
./configure --with-http\_ssl\_module \\  
\--with-pcre=/usr/local/src/pcre-8.41 \\  
\--with-zlib=/usr/local/src/zlib-1.2.11 \\  
\--with-openssl=/usr/local/src/openssl-1.1.0g \\  
\--with-http\_stub\_status\_module \\  
\--add-module=/usr/local/src/ngx\_cache\_purge \\  
\--add-module=/usr/local/src/ngx\_req\_status \\  
\--add-module=/usr/local/src/echo-nginx-module  
make  
make install  
  
这个例子也给出了OpenResty中的模块如何编译进社区最新版nginx中去的方法。我起初看到OpenResty中的模块目录比较怪异，以为还需要自己调整目录结构再整合到nginx中，其实是没有必要的。  
  
安装完成之后，检查nginx.conf的完整性并重启nginx  
/usr/local/nginx/sbin/nginx -t  
/usr/local/nginx/sbin/nginx -s stop  
/usr/local/nginx/sbin/nginx  
![SouthEast][]  
测试请求  
curl -v 'http://localhost:8081/test'

![SouthEast 1][]  
curl -v 'http://localhost:8081/test1'

![SouthEast 2][]  
curl -v 'http://localhost:8081/foo'

![SouthEast 3][]  
curl -v 'http://localhost:8081/bar'  
![SouthEast 4][]  
特殊说明

上面仅是最基本的用法，还有很多高级的用法有待后续深入探索时再补充上来。

下面是做得补充。

server {
            listen 8082;
            server_name localhost;
    
            location /foo {
                set $a hello;
                echo_exec /bar;
            }
    
            location /foo1 {
                set $a hello;
                rewrite ^ /bar;
            }
    
            location /bar {
                echo "a = [$a]";
            }
        }

更新nginx.conf之后，执行下面的命令检查

curl -v 'http://localhost:8082/foo'

![20180106183620763][]  
curl -v 'http://localhost:8082/foo1'  
![20180106183646968][]

下面是更进一步的例子

因为对内建变量 $args 的修改会直接导致当前请求的 URL 参数串发生变化，因此内建变量 $arg\_XXX 自然也会随之变化。

location /test3 {
            set $orig_a $arg_a;
            set $args "a=5";
            echo "original a: $orig_a";
            echo "a: $arg_a";
        }

curl 'http://localhost:8082/test3?a=3'

![SouthEast 5][]

server {
            listen 8083;
            server_name localhost;
     
            location /test {
                set $args "foo=1&bar=2";
                proxy_pass http://127.0.0.1:8084/args;
            }
        }
     
        server {
            listen 8084;
            server_name localhost;
    
            location /args {
                echo "args: $args";
            }
        }

curl -v 'http://localhost:8083/test?blah=7'

![SouthEast 6][]  
父子请求之间的变量共享

location /main {
            echo_location /foo2;
            echo_location /bar2;
        }
     
        location /foo2 {
            echo foo2;
        }
     
        location /bar2 {
            echo bar2;
        }

curl 'http://localhost:8082/main'  
![SouthEast 7][]

location /main3 {
            set $var main;
            echo_location /foo3;
            echo_location /bar3;
            echo "main: $var";
        }
     
        location /foo3 {
            set $var foo;
            echo "foo: $var";
        }
     
        location /bar3 {
            set $var bar;
            echo "bar: $var";
        }

curl -v 'http://localhost:8082/main3'

![SouthEast 8][]

参考文献  
\[1\].https://github.com/openresty/echo-nginx-module  
\[2\].http://blog.sina.com.cn/s/blog\_6d579ff40100wi7p.html

[https_github.com_openresty_echo-nginx-module_installation]: https://github.com/openresty/echo-nginx-module#installation
[https_github.com_taoyunxing_github_test_blob_master_nginx.conf]: https://github.com/taoyunxing/github_test/blob/master/nginx.conf
[SouthEast]: /images/20220602/0abb15da1b444ff8a2ba394712cc4bfe.png
[SouthEast 1]: /images/20220602/add1c65ad5cf491f95edc3fbff182fab.png
[SouthEast 2]: /images/20220602/0b73bfb36dcc42b4b9253d63c63aac6c.png
[SouthEast 3]: /images/20220602/e7020fe4c22d411f92b9006d5b886952.png
[SouthEast 4]: /images/20220602/b8656e40512c4a82a0595d3303f07376.png
[20180106183620763]: /images/20220602/778dd3f268134278915731844b647e0b.png
[20180106183646968]: /images/20220602/f364f11d4e3d4461b1cabb8fdd69c944.png
[SouthEast 5]: /images/20220602/07d9e7ede87749738400effa681f0ffd.png
[SouthEast 6]: /images/20220602/d3b48014e0b746d0a704995414c6e3c0.png
[SouthEast 7]: /images/20220602/4a5f88e143074ea5bb0bb6a83b78003f.png
[SouthEast 8]: /images/20220602/784f01724be54fbd80c70371de1d68b7.png