最近试用了几个@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的实现,更见轻便。