NGINX编译安装动态模块(不需重新编译nginx)

虽然我一贯会自行编译Nginx，而且我多会选用阿里的Tengine或者YiChun Zhang的OpenResty，可难免会遇到一些特殊情况。

例如：我最近接手的一个小项目。其官方运维偏偏选择的是RPM包。如果是Nginx 1.9.11版本之前，我只能选择跟他们的运维商量：“hi，哥们！我需要用到的一些第三方模块必须重新编译安装Nginx呢！” 所幸，他们用的Centos 7.0，而官方的RPM仓库自带的版本已经支持到Nginx 1.10.2啦。我深呼吸一下，考虑到他们的使用习惯，我作出了第二个选择：Nginx动态模块。

可是。。。我真的是第一次操作动态模块的编译和加载。所以，我才会写下这则手记。

我主要参考的三篇文章如下：

• https://www.nginx.com/blog/compiling-dynamic-modules-nginx-plus/
• https://www.nginx.com/resources/wiki/extending/new_config/
• https://www.nginx.com/resources/wiki/extending/converting/

我这里记录一下ngx_cache_purge的动态编译过程。

cd /usr/local/src #养成源码统一放置的位置，方便你我他。这家在职运维是到处乱丢的，吐槽一下！
nginx -v #返回的是nginx version: nginx/1.10.2, 确保下一步源码版本一致哟
wget -c http://nginx.org/download/nginx-1.10.2.tar.gz
wget -c https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz -O ngx_cache_purge_2.3.tar.gz
tar zxf nginx-1.10.2.tar.gz
tar zxf ngx_cache_purge_2.3.tar.gz

转化动态模块的config文件

因为这个模块比较老，作者并没有对它做config配置的更新。换言之，源码下载后并不能支持编译为动态模块，我们参考官方文档（见上列表），试试看。

cd ./ngx_cache_purge-2.3/
cp config config.bk
vim config
###
if [ "$HTTP_PROXY" = "YES" ]; then
    have=NGX_HTTP_PROXY . auto/have
fi

if [ "$HTTP_FASTCGI" = "YES" ]; then
    have=NGX_HTTP_FASTCGI . auto/have
fi

if [ "$HTTP_SCGI" = "YES" 2]; then
    have=NGX_HTTP_SCGI . auto/have
fi

if [ "$HTTP_UWSGI" = "YES" ]; then
    have=NGX_HTTP_UWSGI . auto/have
fi

ngx_addon_name=ngx_http_cache_purge_module
CACHE_PURGE_SRCS="$ngx_addon_dir/ngx_cache_purge_module.c"

if [ -n "$ngx_module_link" ]; then
    ngx_module_type=HTTP
    ngx_module_name="$ngx_addon_name"
  /  ngx_module_srcs="$CACHE_PURGE_SRCS"

    . auto/module
else
    HTTP_MODULES="$HTTP_MODULES $ngx_addon_name"
    NGX_ADDON_SRCS="$NGX_ADDON_SRCS $CACHE_PURGE_SRCS"
fi

have=NGX_CACHE_PURGE_MODULE . auto/have
###

现在，我们可以进行动态模块的编译啦。

cd ../nginx-1.10.2
nginx -V
./configure --add-dynamic-module=../ngx_cache_purge-2.3/ ##这一步要注意：必须将之前的配置指令都拷贝过来，否则会有binary不兼容错误。
make modules
ls objs/

一切正常的话，输出会提示将so文件输出到了objs目录下。 他们这台服务器也没有SUDO相关配置，所以我以上都是以root身份直接运行的。您可能需要su指令。

最后，我们加载动态模块测试。

cp objs/ngx_http_cache_purge_module.so /usr/lib64/nginx/modules/
vim /usr/share/nginx/modules/mod-http-cache-purge.conf #该服务器是CENTOS 7.0，我看到nginx.conf中已经存在载入动态模块的include语句，所以就按照约定执行
###
load_module "/usr/lib64/nginx/modules/ngx_http_cache_purge_module.so";
###
systemctl restart nginx