1. phases
nginx将数据处理过程划分为几个阶段（phase）。
2. ngx_http_phase_handler_pt 与 ngx_http_handler_pt
每个阶段可以挂接若干处理函数，ngx_http_core_run_phase() 按阶段调用这些函数。不管是Nginx自身的nginx_module，还是使用者的ngx_module，都可以挂接自己的处理函数。这个处理函数的原型定义是ngx_http_handler_pt。
typedef ngx_int_t (*ngx_http_handler_pt)(ngx_http_request_t *r);
挂接的位置是ngx_http_core_main_conf_t.phases[]数组，保存ngx_http_phase_t结构。Ngx_http_phase_t.handlers[]是一个ngx_http_phase_t数组，每个phase一个元素。Ngx_http_phase_t的成员handlers也是一个数组，该阶段的处理函数ngx_http_handler_pt都注册在这里。
实际上处理http请求时，并不是使用ngx_http_core_main_conf_t.phases[]，而是ngx_http_core_main_conf_t.phase_engine。Ngx_http_phase_engint_t.handlers是一个ngx_http_phase_handler_t。
ngx_http_handler_pt只是ngx_module挂接的处理函数。Ngx_http_phase_handler_pt则是每个phase指定的校验函数。如果校验通过，校验函数才会调用处理函数。
typedef ngx_int_t (*ngx_http_phase_handler_pt)(ngx_http_request_t *r,
ngx_http_phase_handler_t *ph);
ngx_http_phase_handler_t包括了校验函数和处理函数。
- 成员checker是phase校验函数。
- 成员handler是处理函数。
- 成员next指定每个ngx_http_phase_handler_t实例在http请求处理过程中的“下一站”。
3. ngx_http_init_phases()
ngx_http_init_phases() 初始化ngx_http_core_main_conf.phases[]中的处理函数数组。
4. ngx_http_module_t::postconfiguration()
在ngx_http_module_t::postconfiguration()中，nginx模块向ngx_http_core_main_conf_t.phases中，加入自己的的处理函数。对于ngx_http_auth_basic_module模块，就是ngx_http_auth_basic_init()。
- 调用ngx_array_push()，向NGX_HTTP_ACCESS_PHASE阶段，加入处理函数ngx_http_auth_basic_handler。
5. ngx_http_init_phase_handlers()
ngx_http_init_phase_handlers()初始化ngx_core_main_conf_t.phase_engine.handlers[]。
- 遍历ngx_http_core_main_conf_t.phases[]，计算其中的处理函数数量。
- 调用ngx_pcalloc()分配对应的ngx_http_phase_handler_t数组，也就是ngx_core_main_conf_t.phase_engine.handlers[]。
- 遍历ngx_http_core_main_conf_t.phases[]数组，将其中的处理函数，一一复制到ngx_http_core_main_conf_t.phase_engine.handlers[]中，同时补充相应phase的校验函数。同时每个ngx_http_phase_handler_t的下一站，也就是它的成员next。
这个过程的大致情形如下图。
- 图左边的每个阶段为一个实线框， 每个阶段指定一个校验函数ngx_http_phase_handler_pt，一组处理函数ngx_http_handler_t。
- 图右边，所有的ngx_http_phase_handler_t实际上是保存在同一个数组中。虚线框是为了使复制的关系看得更清楚。
6. ngx_http_block()
在ngx_http_block()中调用以上函数。
如下是缺省情况（不定制或拓展nginx的功能）下，最后ngx_http_core_main_conf_t.phase_engine.handlers[]的布局。
7. ngx_http_core_run_phases()
ngx_http_core_run_phases() 在一个循环中访问ngx_http_core_main_conf_t.phase_engine.handlers[]，调用其中的校验函数和处理函数。
访问位置由ngx_http_request_t.phase_handler指定，这个值一开始为0，后来校验函数会改变它，所以ngx_http_core_run_phase()会在ngx_http_core_main_conf_t.phase_engine.handlers[]中跳转。
校验函数和处理函数的一个例子是ngx_http_core_access_phase()和ngx_http_auth_basic_handler()。
7.1 ngx_http_phase_handler_t::handler()
在ngx_http_auth_basic_handler()中，
- 调用ngx_http_auth_basic_user()，得到用户数据。
- 调用ngx_open_file()，打开用户数据文件。
- 在一个循环中调用ngx_read_file()，读取用户数据文件的记录。将请求中的用户信息与记录比较，看是否匹配。
7.2 ngx_http_phase_handler_t::checker()
在ngx_http_core_access_phase()中，
调用当前ngx_http_phase_handler_t实例的handler函数，这里是ngx_http_auth_basic_handler()。
-
根据handler函数的返回结果跳转，一般有三种情况。
- 一是handler函数的结果不能确定怎么处理请求，所以ngx_http_request_t.phase_handler递增1。这样ngx_http_core_run_phases()的下一次循环，将跳转到数组phase_engine.handlers[]的下一个元素去执行。
- 二是handler函数的结果确定本阶段的任务已经完成，所以请求ngx_http_request_t.phase_handler设置为当前ngx_http_phase_handler_t.next的值。这样ngx_http_core_run_phases()的下一次循环，将跳到该值指向的位置。这个值在ngx_http_init_phase_handlers()确定。
- 三是handler函数的结果确定所有任务已经结束（比如请求失败），所以返回NGX_OK。这时ngx_http_core_run_phases()会终止循环。
相关链接
nginx 1.18 源代码分析 （一）
nginx 1.18 源代码分析 （二）
nginx 1.18 源代码分析 （三）
nginx 1.18 源代码分析 （四）
nginx 1.18 源代码分析 （五）
nginx 1.18 源代码分析 （六）
