Nginx学习笔记(一):Configure命令详解

前言


       一直打算深入学习一下开源项目,这一个月来的任务,对于修改IPMI开源软件也确实增长了对于开源项目的认识,期间碰到与解决的问题也让我收获不小。这一块可以说是为我学习Nginx开了个好头。

       为什么学习Nginx?当然是随主流,毕竟群众的眼睛是雪亮的。基本上,我能搜到的被推荐的开源项目,Nginx基本都在推荐之列。不犹豫,就是它了。


Configure详解


       在编译安装Nginx时,我们需要使用configure命令做大量"幕后“工作,包括检测操作系统内核和已经安装的软件,参数解析,中间目录生成以及根据各种参数生成的.c文件、Makefile文件等。


一、命令参数(略)

       Configure包含的参数使用以下命令查看:

       ./configure --help

       主要分为五大类:1,路径相关;2,编译相关;3,依赖软件相关;4,模块相关;5,其他;


二、Configrue执行流程

        Configure本身是一个Shell脚本,中间会调用/auto/目录下别的脚本执行。其内容如下:

#!/bin/sh

# Copyright (C) Igor Sysoev
# Copyright (C) Nginx, Inc.

# 设置环境变量。这里是为了去除所有本地化设置,让命令正确执行
LC_ALL=C
export LC_ALL

# 处理configure命令的参数。options脚本将会定义后续工作将会用到的变量,之后进行相应设置。
. auto/options

# 初始化后续产生的文件路径。比如Makefile,默认情况下/objs/
. auto/init

# 分析nginx源码结构,构造后续的Makefile文件
. auto/sources

# 编译过程中所有生成目标文件存放的文件夹
test -d $NGX_OBJS || mkdir $NGX_OBJS

# 建立ngx_auto_hearder.h、autoconf.err等必要的编译文件
echo > $NGX_AUTO_HEADERS_H
echo > $NGX_AUTOCONF_ERR

# 向ngx_auto_config.h文件写入命令行带的参数
echo "#define NGX_CONFIGURE \"$NGX_CONFIGURE\"" > $NGX_AUTO_CONFIG_H

# 判断DEBUG标志,如果有,则在ngx_auto_config.h中写入DEBUG宏
if [ $NGX_DEBUG = YES ]; then
    have=NGX_DEBUG . auto/have
fi

# 开始检查操作系统参数是否支持后续编译
if test -z "$NGX_PLATFORM"; then
    echo "checking for OS"

    NGX_SYSTEM=`uname -s 2>/dev/null`
    NGX_RELEASE=`uname -r 2>/dev/null`
    NGX_MACHINE=`uname -m 2>/dev/null`

# 输出操作系统名称、内核版本、32/64内核
    echo " + $NGX_SYSTEM $NGX_RELEASE $NGX_MACHINE"

    NGX_PLATFORM="$NGX_SYSTEM:$NGX_RELEASE:$NGX_MACHINE";

    case "$NGX_SYSTEM" in
        MINGW32_*)
            NGX_PLATFORM=win32
        ;;
    esac

else
    echo "building for $NGX_PLATFORM"
    NGX_SYSTEM=$NGX_PLATFORM
fi

# 检查并设置编译器,如gcc时候安装,gcc版本时候支持后续编译nginx
. auto/cc/conf

# 对于非Windows系统定义一些必要头文件,并检查其是否存在,以此决定configure后续步骤是否可执行。
# 注: 检查某头文件是否存在或者某特性的类似操作,这里都是通过生成一个最简单的main函数C程序,该程序包含响应的头文件,然后编译检查其是否通过。具体的结果记录在autoconf.err文件中。
if [ "$NGX_PLATFORM" != win32 ]; then
    . auto/headers
fi

# 对于当前操作系统,定义特定的操作系统相关方法并检查当前环境是否支持。比如对于linux,设置进程优先级,使用sendfile系统调用
. auto/os/conf

# 定义类UNIX操作系统的头文件和系统调用等,并检查当前环境是否支持
if [ "$NGX_PLATFORM" != win32 ]; then
    . auto/unix
fi

# !!!重要!!!
# 生成ngx_modules.c文件,此文件会被编译进nginx,它唯一定义ngx_modules数组。此数组指明nginx运行期间有哪些模块会参与到请求处理中。数组中的顺序就是模块优先级的顺序。  
. auto/modules

# 检查nginx在链接期间需要连接的第三方静态库、动态库或目标文件是否存在
. auto/lib/conf

# 处理nginx安装后的路径
case ".$NGX_PREFIX" in
    .)
        NGX_PREFIX=${NGX_PREFIX:-/usr/local/nginx}
        have=NGX_PREFIX value="\"$NGX_PREFIX/\"" . auto/define
    ;;

    .!)
        NGX_PREFIX=
    ;;

    *)
        have=NGX_PREFIX value="\"$NGX_PREFIX/\"" . auto/define
    ;;
esac

# 处理nginx安装后conf文件的路径
if [ ".$NGX_CONF_PREFIX" != "." ]; then
    have=NGX_CONF_PREFIX value="\"$NGX_CONF_PREFIX/\"" . auto/define
fi

# 处理nginx安装后,二进制文件、pid、lock等其他文件路径
have=NGX_SBIN_PATH value="\"$NGX_SBIN_PATH\"" . auto/define
have=NGX_CONF_PATH value="\"$NGX_CONF_PATH\"" . auto/define
have=NGX_PID_PATH value="\"$NGX_PID_PATH\"" . auto/define
have=NGX_LOCK_PATH value="\"$NGX_LOCK_PATH\"" . auto/define
have=NGX_ERROR_LOG_PATH value="\"$NGX_ERROR_LOG_PATH\"" . auto/define

have=NGX_HTTP_LOG_PATH value="\"$NGX_HTTP_LOG_PATH\"" . auto/define
have=NGX_HTTP_CLIENT_TEMP_PATH value="\"$NGX_HTTP_CLIENT_TEMP_PATH\""
. auto/define
have=NGX_HTTP_PROXY_TEMP_PATH value="\"$NGX_HTTP_PROXY_TEMP_PATH\""
. auto/define
have=NGX_HTTP_FASTCGI_TEMP_PATH value="\"$NGX_HTTP_FASTCGI_TEMP_PATH\""
. auto/define
have=NGX_HTTP_UWSGI_TEMP_PATH value="\"$NGX_HTTP_UWSGI_TEMP_PATH\""
. auto/define
have=NGX_HTTP_SCGI_TEMP_PATH value="\"$NGX_HTTP_SCGI_TEMP_PATH\""
. auto/define

# 创建编译时使用的Makefile文件
. auto/make

# 为Makefile加入需要链接的第三方静态库、动态库或者目标文件
. auto/lib/make

# 为Makefile加入install功能
. auto/install

# STUB 在ngx_auto_config.h中加入NGX_SUPPRESS_WARN、NGX_SMP宏
. auto/stubs

# 在ngx_auto_config.h文件指定NGX_USER和NGX_GROUP宏,如果执行configure时无指定参数,则默认nobody,即默认以nobody用户运行进程
have=NGX_USER value="\"$NGX_USER\"" . auto/define
have=NGX_GROUP value="\"$NGX_GROUP\"" . auto/define

# 显示configure执行结果
. auto/summary


三、Configure生成文件

        Configure执行成功会生成objs目录,如下图:

          Nginx学习笔记(一):Configure命令详解_第1张图片

       重点在ngx_modeles.c文件,其中定义了ngx_modules数组,它指明每个模块在Nginx中的优先级。当一个请求同时符合多个模块处理规则时,将按照此数组中的顺序选择最靠前的模块优先处理。


总结

       Configurex所做工作:寻找Nginx所依赖软件,针对不同操作系统做的优化,生成Makefile,ngx_XXX.h文件,ngx_modules.c文件。其中,ngx_modules.c文件决定运行时所有模块的优先级。对于不需要的模块,即不会加入ngx_modules数组,也就不会编进Nginx中,体现了其轻量级概念。


主要参考:

《深入理解Nginx》



你可能感兴趣的:(深入理解Nginx,Nginx学习笔记系列)