Nginx开发HTTP模块（八）：用C++语言编写HTTP模块

---

---

前言

Nginx及其官方模块都是由C语言开发的，但当我们由于各种原因需要使用C++语言实现一个Nginx模块时，由于C语言和C++语言的近亲特性，还是可以比较容易达成此目的的。

---

一、使用C++编写HTTP模块相关解决方案的设计思路

• 不要试图用C++编译器来编译Nginx的官方代码，这会带来大量的不可控错误。正确的做法是仍然用C编译器来编译Nginx官方提供的各模块，而用C++编译器来编译用C++语言开发的模块，最后利用C++向前兼容C语言的特性，使用C++编译器把所有的目标文件链接起来（包括C编译器由Nginx官方模块生成的目标文件和C++编译器由第三方模块生成的目标文件），这样才可以正确地生成二进制文件Nginx。
• 保证C++编译的Nginx模块与C编译的Nginx模块互相适应。所谓互相适应就是C++模块要能够调用Nginx框架提供的C语言方法，而Nginx的HTTP框架也要能正常的回调C++模块中的方法去处理请求。这一点用C++提供的extern " C "特性即可实现。

二、如何实现上述设计思路

1. 编译方式的修改

Nginx的configure脚本没有对C++语言编译模块提供支持，修改编译方式有以下两种思路：

• 修改configure相关的脚本（不推荐）。
  • 缺点：Nginx的一个优点是具备大量的第三方模块，这些模块都是基于官方的configure脚本而写的，擅自修改configure脚本会导致我们的Nginx无法使用第三方模块。
• 修改configure执行完毕后生成的Makefile文件（推荐）。

  CC =    cc
  CXX = g++
  CFLAGS =  -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g
  CPP =   cc -E
  LINK =  $(CXX)
  
  ...
  objs/addon/httpmodule/ngx_http_mytest_module.o:  $(ADDON_DEPS) \
  		../sample/http_modules//ngx_http_mytest_module.c 
  		$(CXX) -c $(CFLAGS) $(ALL_INCS) \
  				-o objs/addon/http/httpmodule/ngx_http_mytest_module.o \
  				../sample/httpmodule//ngx_http_mytest_module.c
  

  • 在Makefile文件收不新增了一行CXX = g++，即添加了C++编译器。
  • 把链接方式LINK = $(CC)改为了LINK = $(CXX)，表示用C++编译器做最后的链接。
  • 把模块的编译方式修改为C++编译器。如果我们只有一个C++源文件，则只要修改一处，但如果有多个C++源文件，则每个地方都需要修改。修改方式是把$(CC)改为$(CXX)。

修改源文件后不要轻易执行configure脚本，否则会覆盖已经修改过的Makefile。建议将修改过的Makefile文件进行备份，避免每次执行configure后重新修改Makefile。

2. 程序中的符号转换

C语言与C++语言最大的不同在于编译后的符号有差别，这可以通过C++语言提供的extern “C” {}来实现符号的互相识别。在C++语言开发的模块中，include包含的Nginx官方文件都需要使用extern "C"括起来。

extern "C" {
	#include <ngx_config.h>
	#include <ngx_core.h>
	#include <ngx_http.h>
}

这样就可以正常地调用Nginx的各种方法了。
另外，对于希望Nginx框架回调的类似于ngx_http_mytest_handler这样的方法也需要放在extern "C"中。

总结

本文介绍了使用C++开发Nginx的HTTP模块的可行性以及实现的具体思路，并对开发过程中需要注意的细节进行了介绍。