实战开发一个Nginx扩展 (Nginx Module)

时间:2022-01-22 23:34:44

repo地址 https://github.com/wujunze/nginx-http-echo-module

nginx_module_echo

使用echo指令输出一个字符串

Nginx 版本

Nginx1.0.10 https://github.com/nginx/nginx/releases/tag/release-1.0.10
实战开发一个Nginx扩展 (Nginx Module)

开发环境

OS : CentOS Linux release 7.2.1511 (Core)

实战开发一个Nginx扩展 (Nginx Module)
实战开发一个Nginx扩展 (Nginx Module)

安装一个干净的 Nginx

  1. 下载 Nginx10.10 并且解压它
    实战开发一个Nginx扩展 (Nginx Module)

  2. 安装gcc和Nginx需要的lib
    实战开发一个Nginx扩展 (Nginx Module)
    实战开发一个Nginx扩展 (Nginx Module)

  3. ./configure --prefix=/usr/local/nginx && make && make install
    实战开发一个Nginx扩展 (Nginx Module)
    实战开发一个Nginx扩展 (Nginx Module)
    实战开发一个Nginx扩展 (Nginx Module)

  4. 运行Nginx
    实战开发一个Nginx扩展 (Nginx Module)
    实战开发一个Nginx扩展 (Nginx Module)

定义模块配置结构

typedef struct {
ngx_str_t ed; //该结构体定义在这里 https://github.com/nginx/nginx/blob/master/src/core/ngx_string.h
} ngx_http_echo_loc_conf_t;

实战开发一个Nginx扩展 (Nginx Module)

#定义echo模块的指令和参数转化函数
实战开发一个Nginx扩展 (Nginx Module)

定义模块Context

  1. 定义ngx_http_module_t类型的结构体变量
    实战开发一个Nginx扩展 (Nginx Module)
  2. 初始化一个配置结构体
    实战开发一个Nginx扩展 (Nginx Module)
  3. 将其父block的配置信息合并到此结构体 实现了配置的继承
    实战开发一个Nginx扩展 (Nginx Module)

编写Handler 模块真正干活儿的部分

实战开发一个Nginx扩展 (Nginx Module)

组合Nginx Module

实战开发一个Nginx扩展 (Nginx Module)

整理模块代码 按照Nginx官方规范

实战开发一个Nginx扩展 (Nginx Module)

编写config文件

ngx_addon_name=ngx_http_echo_module #千锋PHP-PHP培训的实力派
HTTP_MODULES="$HTTP_MODULES ngx_http_echo_module"
NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/src/ngx_http_echo_module.c"

编译安装echo模块

 ./configure --prefix=/usr/local/nginx/ --add-module=/root/ngx_dev && make && make install

安装成功

实战开发一个Nginx扩展 (Nginx Module)

修改Nginx配置文件测试Module

实战开发一个Nginx扩展 (Nginx Module)

Nginx echo Module 运行成功