feature: this module can now be built as a "dynamic module" with NGINX 1.9.11+ via the --add-dynamic-module=PATH option of ./configure. thanks Hiroaki Nakamura for the original patch in openresty#43.

hnakamur · agentzh · commit bad56771a6f2 · 2016-04-21T15:58:57.000-07:00
Signed-off-by: Yichun Zhang (agentzh) &lt;agentzh@gmail.com&gt;
diff --git a/README.markdown b/README.markdown
@@ -1005,18 +1005,26 @@ Alternatively, you can build Nginx with this module all by yourself:
 * and then apply the patch to your nginx source tree that fixes an important bug in the mainline Nginx core: <https://raw.github.com/openresty/openresty/master/patches/nginx-1.4.3-upstream_truncation.patch> (you do NOT need this patch if you are using nginx 1.5.3 and later versions.)
 * after that, download the latest version of the release tarball of this module from srcache-nginx-module [file list](https://github.com/openresty/srcache-nginx-module/tags),
 * and finally build the Nginx source with this module
-```nginx
 
-     wget 'http://nginx.org/download/nginx-1.9.7.tar.gz'
-     tar -xzvf nginx-1.9.7.tar.gz
-     cd nginx-1.9.7/
+```bash
+ wget 'http://nginx.org/download/nginx-1.9.7.tar.gz'
+ tar -xzvf nginx-1.9.7.tar.gz
+ cd nginx-1.9.7/
+
+ # Here we assume you would install you nginx under /opt/nginx/.
+ ./configure --prefix=/opt/nginx \
+      --add-module=/path/to/srcache-nginx-module
 
-     # Here we assume you would install you nginx under /opt/nginx/.
-     ./configure --prefix=/opt/nginx \
-          --add-module=/path/to/srcache-nginx-module
+ make -j2
+ make install
+```
+
+Starting from NGINX 1.9.11, you can also compile this module as a dynamic module, by using the `--add-dynamic-module=PATH` option instead of `--add-module=PATH` on the
+`./configure` command line above. And then you can explicitly load the module in your `nginx.conf` via the [load_module](http://nginx.org/en/docs/ngx_core_module.html#load_module)
+directive, for example,
 
-     make -j2
-     make install
+```nginx
+load_module /path/to/modules/ngx_http_srcache_filter_module.so;
 ```
 
 [Back to TOC](#table-of-contents)
diff --git a/config b/config
@@ -1,5 +1,33 @@
 ngx_addon_name=ngx_http_srcache_filter_module
-HTTP_AUX_FILTER_MODULES="$HTTP_AUX_FILTER_MODULES ngx_http_srcache_filter_module"
-NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/src/ngx_http_srcache_filter_module.c $ngx_addon_dir/src/ngx_http_srcache_util.c $ngx_addon_dir/src/ngx_http_srcache_var.c $ngx_addon_dir/src/ngx_http_srcache_store.c $ngx_addon_dir/src/ngx_http_srcache_fetch.c $ngx_addon_dir/src/ngx_http_srcache_headers.c"
-NGX_ADDON_DEPS="$NGX_ADDON_DEPS $ngx_addon_dir/src/ddebug.h $ngx_addon_dir/src/ngx_http_srcache_filter_module.h $ngx_addon_dir/src/ngx_http_srcache_util.h $ngx_addon_dir/src/ngx_http_srcache_var.h $ngx_addon_dir/src/ngx_http_srcache_fetch.h $ngx_addon_dir/src/ngx_http_srcache_store.h $ngx_addon_dir/src/ngx_http_srcache_headers.h"
 
+HTTP_SRCACHE_FILTER_SRCS="                                                  \
+                        $ngx_addon_dir/src/ngx_http_srcache_filter_module.c \
+                        $ngx_addon_dir/src/ngx_http_srcache_util.c          \
+                        $ngx_addon_dir/src/ngx_http_srcache_var.c           \
+                        $ngx_addon_dir/src/ngx_http_srcache_store.c         \
+                        $ngx_addon_dir/src/ngx_http_srcache_fetch.c         \
+                        $ngx_addon_dir/src/ngx_http_srcache_headers.c       \
+                        "
+
+HTTP_SRCACHE_FILTER_DEPS="                                                  \
+                        $ngx_addon_dir/src/ddebug.h                         \
+                        $ngx_addon_dir/src/ngx_http_srcache_filter_module.h \
+                        $ngx_addon_dir/src/ngx_http_srcache_util.h          \
+                        $ngx_addon_dir/src/ngx_http_srcache_var.h           \
+                        $ngx_addon_dir/src/ngx_http_srcache_fetch.h         \
+                        $ngx_addon_dir/src/ngx_http_srcache_store.h         \
+                        $ngx_addon_dir/src/ngx_http_srcache_headers.h       \
+                        "
+
+if [ -n "$ngx_module_link" ]; then
+    ngx_module_type=HTTP_AUX_FILTER
+    ngx_module_name=$ngx_addon_name
+    ngx_module_srcs="$HTTP_SRCACHE_FILTER_SRCS"
+    ngx_module_deps="$HTTP_SRCACHE_FILTER_DEPS"
+
+    . auto/module
+else
+    HTTP_AUX_FILTER_MODULES="$HTTP_AUX_FILTER_MODULES $ngx_addon_name"
+    NGX_ADDON_SRCS="$NGX_ADDON_SRCS $HTTP_SRCACHE_FILTER_SRCS"
+    NGX_ADDON_DEPS="$NGX_ADDON_DEPS $HTTP_SRCACHE_FILTER_DEPS"
+fi
