Nginx開發(fā)第三方模塊實(shí)例
Ø 序言
Nginx是一個(gè)極具擴(kuò)展性的服務(wù)器,這顯著體現(xiàn)在對(duì)第三方模塊的支持，開發(fā)者能夠?qū)⒆约洪_發(fā)的模塊，按照nginx既有的規(guī)則，完美地融合進(jìn)http框架中，以實(shí)現(xiàn)開發(fā)者定制功能的作用。
這篇文章主要用于結(jié)合如何開發(fā)一個(gè)簡(jiǎn)單的第三方模塊，目標(biāo)人群為想了解nginx開發(fā)第三方模塊的同學(xué)，文章內(nèi)容主要包括三個(gè)部分，如何將HTTP模塊嵌入nginx和如何開發(fā)第三方模塊以及一個(gè)例子。
Ø 如何將HTTP模塊嵌入nginx
Nginx目前來說提供了二種方式,config文件+configure 腳本，手動(dòng)方式，后面手動(dòng)方式是更加復(fù)雜的，且容易出錯(cuò)，在常規(guī)的nginx開發(fā)中，基本上都是用config文件+configure腳本方式比較多。接下來分別介紹這兩種方式。
1) Config文件+configure腳本
l Config文件
這個(gè)是指提供config文件，并且在文件里面給出三個(gè)配置項(xiàng)，就可以達(dá)到效果。這三個(gè)配置項(xiàng)是指：
A. Ngx_addon_name：就是自己要開發(fā)的這個(gè)模塊名字。
B. Nginx模塊名：這有點(diǎn)像設(shè)置環(huán)境變量啥的，首先要知道自己開發(fā)啥模塊，nginx對(duì)應(yīng)的模塊有，$HTTP_MODULES(常規(guī)的http模塊), $HTTP_FILTER_MODULES(HTTP過濾模塊)，$HTTP_HEAD_FILTER_MODULES(HTTP 頭部過濾模塊)， $CORE_MODULES(nginx的核心模塊)，$EVENT_MODULES(nginx的事件模塊)等，然后在后面添加你所要添加的模塊名字，以空格隔開，比如這次我們開發(fā)添加的模塊:
HTTP_MODULES = “$HTTP_MODULES ngx_http_helloworld_module”
C. NGX_ADDON_SRCS：這個(gè)顧名思義，就是指定新添加文件的路徑，不過這個(gè)都是相對(duì)路徑，因?yàn)樵?/span>configure的時(shí)候就指定了上層路徑，比如--add-modules=PATH。
比如我們這次開發(fā)要添加的源文件：
NGX_ADDON_SRCS = “$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_helloworld_module.c”
l Configure腳本
這里需要用- -add-module=PATH將第三方模塊的路徑加入，
比如configure - -add-module=~/ngx_3rd_modules/
那我們能分析下這背后做了什么呢？我們從下面兩個(gè)部分來展開說明
a) Auto/modules
這個(gè)主要是說明將定制的第三方模塊添加到生成的ngx_modules.c里面。
a) 指定模塊下面的配置文件.
b) 生成模塊信息
一、生成模塊數(shù)組
根據(jù)需要開啟的模塊加載對(duì)應(yīng)的模塊,下面是開啟http模塊后的所需要的模塊
二、生成ngx_modules.c文件
b) Auto/make
顯而易見，這個(gè)就是負(fù)責(zé)編譯相關(guān)的模塊。
1) 生成第三方源碼
2) 生成鏈接代碼，并將目標(biāo)文件，庫文件鏈接成二進(jìn)制程序
2) 手動(dòng)方式
分兩步來做，第一，修改obj/ngx_modules.c, 在里面增加對(duì)應(yīng)的第三方模塊，第二，修改obj/Makefile,在里面增加第三方模塊的編譯，這種直接修改的方法不太可取，易出錯(cuò)，一般都是用上面的第二種方法。
Ø 開發(fā)第三方模塊注意事項(xiàng)
首先,要確定針對(duì)那個(gè)模塊進(jìn)行開發(fā)，nginx的模塊是有順序性的，比如： HTTP_MODULES = “$HTTP_MODULES ngx_http_helloworld_module”
其次，因?yàn)?/span>nginx是異步非阻塞的，在編制代碼時(shí)，一定要注意不能阻塞nginx進(jìn)程.
Ø 示例
見附件/Files/jolleydtan/test.zip
參考：
深入理解nginx.