smallfish bio photo

smallfish

Engineer at Alibaba, Taobao.com #golang #clojure #nginx-lua #postgres

Email Twitter Github

最近试用了几个@agentzh写的第三方Nginx模块,甚为愉悦,没想到在Nginx可以玩很多技巧和扩展,分享一下。

本文尝试的几个模块大概分为:

  • echo
  • memcached
  • nginx
  • lua

详细模块地址分别为:

为了省事这里一股脑把上面的module全部下载好,一起编译。PS:如果更懒惰的可以尝试下openresty项目,它帮你打包好Nginx和一堆扩展模块,得感谢@agentzh。

这里编译和drizzle和lua模块,在编译Nginx之前需要设置一下这两个库的LIB和INCLUDE文件地址:

-- lua --
export LUA_LIB=/path/to/lua/lib
export LUA_INC=/path/to/lua/include

-- drizzle --
export LIBDRIZZLE_INC=/opt/drizzle/include/libdrizzle-1.0
export LIBDRIZZLE_LIB=/opt/drizzle/lib

Nginx编译选项如下,请注意先后顺序:

./configure --prefix=/opt/nginx \
    --with-pcre=../pcre \
    --add-module=../ngx_devel_kit \
    --add-module=../set-misc-nginx-module \
    --add-module=../memc-nginx-module \
    --add-module=../echo-nginx-module \
    --add-module=../lua-nginx-module \
    --add-module=../srcache-nginx-module \
    --add-module=../drizzle-nginx-module \
    --add-module=../rds-json-nginx-module

重新编译Nginx二进制,Nginx需要quit再启动。而普通配置更新则reload即可:

1. kill -HUP `cat /path/nginx/logs/nginx.pid`
2. /path/nginx/sbin/nginx -s reload

PS:详细的模块编译可以参考各自模块的文档说明。

好吧,假设到这里已经安装和编译好Nginx以及一堆第三方扩展。下面开始尝试上面那些有趣的模块~

场景1:Helloworld

程序里helloworld很简单,nginx的hello如何实现呢?

1. 最简单的helloworld
location /hello1 {
    echo "hello 1111!";
}

2. 异步请求其他echo请求
location /hello2 {
    echo "hello 2222!";
    echo_location_async /hello1;
}

3. 输出GET请求参数,假设参数名是name,这里并对name参数进行解码
location /hello3 {
    set_unescape_uri $name $arg_name;
    set_if_empty $name "None";
    echo "hello, $name!";
}

是不是很帅气有趣。例2中的subrequest是完全non-blocking的。
echo模块还有timer扩展,页面输出加载时间也是小case了。

场景2:Memcached HTTP 接口

想当年哥为了兼容不同语言的api,自己封装了memcached操作,真是挺苦逼的,当时还非常羡慕tokyotyrant的http接口来着,现在用memc模块效果一样,还有upstream和keepalive功能哦~

location /memcached {
    set $memc_cmd $arg_cmd;
    set $memc_key $arg_key;
    set $memc_value $arg_val;
    set $memc_exptime $arg_exptime;
    memc_pass 127.0.0.1:11211;
}

URL访问类似 http://host:port/memcached?cmd=aaa&key=bbb&val=ccc

还需要自己封装么?完全的基于url编程了,不再考虑各自语言的memcached api,cluster也简化了。

场景3:数据库查询

这里用了libdrizzle模块,兼容MySQL、Drizzle、SQLite数据库。有时候为了一些查询或者接口,还需要用语言来封装一些数据库查询操作,现在直接通过drizzle模块可以很轻松的做到~~

# 添加MySQL配置
upstream mysql {
    drizzle_server 127.0.0.1:3306 dbname=test user=smallfish password=123 protocol=mysql;
}

# 通过url匹配出name,并编码防止注入,最后以json格式输出结果。
location ~ '^/mysql/(.*)' {
    set $name $1;
    set_quote_sql_str $quote_name $name;
    set $sql "SELECT * FROM users WHERE name=$quote_name";
    drizzle_query $sql;
    drizzle_pass mysql;
    rds_json on;
}

# 查看MySQL服务状态,这个很实用哦。
location /mysql-status {
    drizzle_status;
}

场景4:lua扩展

内嵌lua语言,超级牛力哦~~~想干啥都可以了,而且还可以充分发挥lua coroutine的风骚,淘宝量子统计完全是lua扩展。

location /lua1 {
    default_type 'text/plain';
    content_by_lua 'ngx.say("hello, lua")';
}

# 请求另外的url
location /lua2 {
    content_by_lua '
        local res = ngx.location.capture("/hello1")
        ngx.say("data: " .. res.body)
     ';
}

Lua支持的选项很多,具体可参考官网WIKI文档。

嗯,这里尝试玩了几个模块,详细的例子可以参考各自的模块文档,里面都有详细的说明和选项配置。

可以看出和传统编程有些微不同之处,完全是基于URL的HTTP接口,比传统的方式更为简单,更为清晰。还有non-blocking的实现,更见轻便。

END