nginx源码分析configure脚本详解

     在之前介绍event模块的时候，讲到init_cycle函数中对cycle进行了初始化，其中很重要一步操作就是讲包含所有module信息的数组拷贝到这个cycle对应的结构中（nginx/src/core/ngx_module.c），文件中函数用到的包含module名称的数组ngx_module_names在源码中也没找到定义、初始化。

     由于nginx拥有丰富的功能选项，因此有经验的使用者都会采用直接源码编译、安装的方式。在编译前，需要通过执行如下命令来完成源代码的编译。

cd <code>--with-pcre &amp;&amp;</code> <code><code>     打开nginx/auto/configure文件，发现该文件是一个shell脚本，并调用了一些其他文件 </code></code>

################## nginx/auto/configure #######################

<code># Copyright (C) Igor Sysoev</code>

<code>LC_ALL=C</code>

<code> </code> 

<code>#文件中命令与options的命令都在同一sh环境下，所以变量在两个文件中都是彼此可见的</code>

<code>#设置变量，并将之置空</code>

<code>#初始化一些变量诸如：NGX_AUTO_HEADERS_H=$NGX_OBJS/ngx_auto_headers.h</code>

<code>#设置核心模块、平台代码对应的源文件</code>

<code>-d $NGX_OBJS ||</code> <code> </code> 

<code>echo</code> <code>echo</code> <code> </code> 

<code>then</code>

<code>/have</code>   <code> </code> 

<code>. auto</code> <code> </code> 

<code>"$NGX_PLATFORM"</code> <code>  </code> <code>#检查相关头文件，并将结果输出到ngx_auto_headers.h文件中</code>

<code>"$NGX_PLATFORM"</code> <code>  </code> <code>#检查unix环境下一些文件、函数</code>

<code>. auto</code> <code>#统计要编译到nginx中的模块信息，创建并初始化ngx_module_t *ngx_modules[]和</code>

<code>. auto</code> <code>/lib/conf</code>

<code>"\"$NGX_SBIN_PATH\""</code> <code>have=NGX_CONF_PATH value=</code> <code>/define</code>

<code><code> </code> </code>

<code><code>NGX_PCRE宏定义，这类的宏定义可以在nginx/objs/ngx_auto_config.h中看到，这个文件是由have=$ngx_have_feature . auto/have这样的语句生成的。 </code></code>

################ nginx/auto/have ##############

<code>#endif</code>

<code><code>     文件中&lt;&lt;符号是来告知shell标准输入来自一对分隔符（可以使字符串、数字等类型，只要保证开头和结尾的一致）中间的内容；所以，have文件中的命令就是利用cat将分隔符END之间的5行内容追加到$NGX_AUTO_CONFIG_H文件中。效果如下： </code></code>

#ifndef NGX_PCRE

<code><code>     这就回答了第一个问题。  </code></code>

?

<code>modules=</code> <code>cat</code> <code>#include &lt;ngx_config.h&gt;</code>

<code>$NGX_PRAGMA</code>

<code>mod</code> <code>do</code>

<code>"extern ngx_module_t $mod;"</code>     <code> </code> 

<code>&gt;&gt; $NGX_MODULES_C</code>

<code>"  &amp;$mod,"</code>             <code> </code> 

<code>  </code> <code> </code> 

<code>#定义并初始化char *ngx_module_names[]数组，然后输出重定向到$NGX_MODULES_C</code>

<code>"  \"$mod\","</code>           <code> </code> 

<code><code>nginx/auto/modules这个文件生成的两个数组用于cycle的初始化，因此如果开发者开发的模块要添加到nginx中，一定要记得修改nginx/auto/modules这个文件，否则是不会被编译到nginx中的（当然不会生效啦）。</code></code>

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

<code>"poll()"</code>

<code>ngx_feature_incs=</code> <code>ngx_feature_libs=</code>

<code></code>

<code>         </code> <code>pl.revents = 0;</code>

<code>         </code> <code>return</code> <code>. auto</code> <code>#如果上述的测试结果表明该feature不可用，就将相应的宏设置为NONE</code>

<code>fi</code>

<code>?</code>

......

<code>cat</code> <code>#include &lt;sys/types.h&gt;</code>

<code>$ngx_feature_test;</code>

<code>0;</code>

<code>END</code>

<code>ngx_test="$CC $CC_TEST_FLAGS $CC_AUX_FLAGS $ngx_feature_inc_path \</code>

<code>"/bin/sh -c \"$ngx_test\" &gt;&gt; $NGX_AUTOCONF_ERR 2&gt;&amp;1"</code>

<code>if</code> <code>   </code> <code>case</code> <code>    </code> <code>      </code> <code>#执行对应的可执行程序，并重定向输出</code>

<code>/bin/sh</code> <code>        </code> <code>echo</code> <code>ngx_found=</code> <code>        </code> <code>if</code> <code>"$ngx_feature_name"</code> <code>          </code> <code>        </code> <code>      </code> <code>echo</code> <code>fi</code>

<code>......</code>