Nginx核心知识100讲学习笔记（陶辉）详解HTTP模块（详解11阶段）

Syntax server_name_in_redirect on | off;
Default server_name_in_redirect off;
Context http, server, location

server {
	server_name primary.luoahong.tech second.luoahong.tech;
	server_name_in_redirect on;
	return 302 /redirect;

}

[root@ceph-client vhost]# curl second.luoahong.tech -I
HTTP/1.1 302 Moved Temporarily
Server: openresty/1.13.6.2
Date: Wed, 26 Aug 2020 01:26:22 GMT
Content-Type: text/html
Content-Length: 167
Location: http://primary.luoahong.tech/redirect
Connection: keep-alive

[root@ceph-client conf]# nginx -s reload
[root@ceph-client vhost]# curl second.luoahong.tech -I
HTTP/1.1 302 Moved Temporarily
Server: openresty/1.13.6.2
Date: Wed, 26 Aug 2020 01:26:09 GMT
Content-Type: text/html
Content-Length: 167
Location: http://second.luoahong.tech/redirect
Connection: keep-alive

server_name *.luoahong.com

server_name www.luoahong.com ~^wwwd+.luoahong.com$;

server {
  server_name ~^(www.)?(.+)$;
  location / { root /sites/$2; }
}

server {
  server_name ~^(www.)?(?<domain>.+)$;
  location / { root /sites/$domain; }
}

.luoahong.tech可以匹配 luoahong.tech *.luoahong.tech
_匹配所有
"" 匹配没有传递Host头部

typedef enum {
    //在接收到完整的HTTP头部后处理的HTTP阶段
    NGX_HTTP_POST_READ_PHASE = 0,
 
    //在请求的URI与location表达式匹配前，修改请求的URI(重定向)，是一个独立的HTTP阶段
    NGX_HTTP_SERVER_REWRITE_PHASE,
 
    //根据请求的URI寻找匹配的location表达式，这个阶段只能由
    NGX_HTTP_FIND_CONFIG_PHASE,
         
    //在NGX_HTTP_FIND_CONFIG_PHASE阶段寻找到匹配的location之后再修改请求的URI
    NGX_HTTP_REWRITE_PHASE,
         
    //这一阶段是用于在rewrite重写URL后，防止错误的nginx.conf配置导致死循环(递归地修改URI)
    NGX_HTTP_POST_REWRITE_PHASE,
 
    //表示在处理NGX_HTTP_ACCESS_PHASE阶段觉得请求的访问权限前，HTTP模块可以介入的处理阶段
    NGX_HTTP_PREACCESS_PHASE,
 
    //这个阶段用于让HTTP模块判断是否允许这个请求访问nginx服务器
    NGX_HTTP_ACCESS_PHASE,
         
    //在NGX_HTTP_ACCESS_PHASE阶段中，当HTTP模块的handler处理函数返回不允许访问的错误码时(NGX_HTTP_FORBIDDEN或者NGX_HTTP_UNAUHORIZED)，这里将负责向用户发送拒绝服务的错误响应。
    NGX_HTTP_POST_ACCESS_PHASE,
 
    //此阶段专门为try_files配置项设立，当HTTP请求访问静态文件资源时，try_files配置项可以使这个配置项顺序地访问多个静态文件资源
    NGX_HTTP_TRY_FILES_PHASE,
         
    //用于处理HTTP请求内容的阶段，这是大部分HTTP模块最愿意介入的阶段
    NGX_HTTP_CONTENT_PHASE,
 
    //处理完请求后记录日志的阶段，ngx_http_log_module模块就在这个阶段中加入了一个handler处理方法，使得每个HTTP请求处理完毕后会记录access_log访问日志
    NGX_HTTP_LOG_PHASE
} ngx_http_phases;
这11个阶段有些是必备的，有些是可选的，也可以有多个HTTP模块同时介入同一阶段

 

HTTP阶段的定义，包括checker检查方法和handler处理方法，如下所示：

typedef structngx_http_phase_handler_s ngx_http_phase_handler_t;
 
/*一个HTTP处理阶段中的checker检查方法，仅可以由HTTP框架实现，以此控制HTTP请求的处理流程*/
typedef ngx_int_t(*ngx_http_phase_handler_pt)(ngx_http_request_t *r, ngx_http_phase_handler_t*ph);
 
/*由HTTP模块实现的handler处理方法*/
typedef ngx_int_t(*ngx_http_handler_pt)(ngx_http_request_t *r);
 
struct ngx_http_phase_handler_s {
	/*在处理到某一个HTTP阶段时，HTTP框架将会在checker方法已实现的前提下首先调用checker方法来处理请求，
	而不会直接调用任何阶段中的hanlder方法，只有在checker方法中才会去调用handler方法，因此，事实上所有
	的checker方法都是由框架中的ngx_http_core_module模块实现的，且普通模块无法重定义checker方法*/
	ngx_http_phase_handler_pt  checker;
	   
	/*除ngx_http_core_module模块以外的HTTP模块，只能通过定义handler方法才能介入某一个HTTP处理阶段以处理请求*/
	ngx_http_handler_pt        handler;
	   
	/*将要处理的下一个HTTP处理阶段的序号
	next的设计使得处理阶段不必按顺序依次执行，既可以向后跳跃数个阶段继续执行，也可以跳跃到之前的某个阶段重新
	执行，通常，next表示下一个处理阶段中的第1个ngx_http_phase_handler_t处理方法*/
	ngx_uint_t                 next;
};

vim /usr/local/src/openresty-1.13.6.2/bundle/nginx-1.13.6/auto/modules
..........
    ngx_module_order="ngx_http_static_module 
                      ngx_http_gzip_static_module 
                      ngx_http_dav_module 
                      ngx_http_autoindex_module 
                      ngx_http_index_module 
                      ngx_http_random_index_module 
                      ngx_http_access_module 
                      ngx_http_realip_module 
                      ngx_http_write_filter_module 
                      ngx_http_header_filter_module 
                      ngx_http_chunked_filter_module 
                      ngx_http_v2_filter_module 
                      ngx_http_range_header_filter_module 
                      ngx_http_gzip_filter_module 
                      ngx_http_postpone_filter_module 
                      ngx_http_ssi_filter_module 
                      ngx_http_charset_filter_module 
                      ngx_http_xslt_filter_module 
                      ngx_http_image_filter_module 
                      ngx_http_sub_filter_module 
                      ngx_http_addition_filter_module 
                      ngx_http_gunzip_filter_module 
                      ngx_http_userid_filter_module 
                      ngx_http_headers_filter_module 
                      ngx_http_copy_filter_module 
                      ngx_http_range_body_filter_module 
                      ngx_http_not_modified_filter_module 
                      ngx_http_slice_filter_module"
..........