Mercurial > hg > nginx-site
comparison xml/cn/docs/http/request_processing.xml @ 720:9934338f83af
Updated the Chinese documentation.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 11 Oct 2012 10:23:05 +0000 |
parents | 130fad6dc1b4 |
children |
comparison
equal
deleted
inserted
replaced
719:6a37df6078a1 | 720:9934338f83af |
---|---|
1 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd"> | 1 <!-- |
2 Copyright (C) Igor Sysoev | |
3 Copyright (C) Nginx, Inc. | |
4 --> | |
5 | |
6 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd"> | |
2 | 7 |
3 <article name="Nginx如何处理一个请求" | 8 <article name="Nginx如何处理一个请求" |
4 link="/cn/docs/http/request_processing.html" | 9 link="/cn/docs/http/request_processing.html" |
5 lang="cn" | 10 lang="cn" |
11 rev="1" | |
12 translator="Jinglong & cfsego" | |
6 author="Igor Sysoev" | 13 author="Igor Sysoev" |
7 editor="Brian Mercer"> | 14 editor="Brian Mercer"> |
8 | 15 |
9 | 16 |
10 <section name="基于名字的虚拟主机"> | 17 <section name="基于名字的虚拟主机"> |
12 <para> | 19 <para> |
13 Nginx首先选定由哪一个<i>虚拟主机</i>来处理请求。让我们从一个简单的配置(其中全部3个虚拟主机都在端口*:80上监听)开始: | 20 Nginx首先选定由哪一个<i>虚拟主机</i>来处理请求。让我们从一个简单的配置(其中全部3个虚拟主机都在端口*:80上监听)开始: |
14 | 21 |
15 <programlisting> | 22 <programlisting> |
16 server { | 23 server { |
17 listen 80; | 24 listen 80; |
18 server_name nginx.org www.nginx.org; | 25 server_name example.org www.example.org; |
19 ... | 26 ... |
20 } | 27 } |
21 | 28 |
22 server { | 29 server { |
23 listen 80; | 30 listen 80; |
24 server_name nginx.net www.nginx.net; | 31 server_name example.net www.example.net; |
25 ... | 32 ... |
26 } | 33 } |
27 | 34 |
28 server { | 35 server { |
29 listen 80; | 36 listen 80; |
30 server_name nginx.com www.nginx.com; | 37 server_name example.com www.example.com; |
31 ... | 38 ... |
32 } | 39 } |
33 </programlisting> | 40 </programlisting> |
34 </para> | 41 </para> |
35 | 42 |
36 <para> | 43 <para> |
37 在这个配置中,nginx仅仅检查请求的Host头以决定该请求应由哪个虚拟主机来处理。如果Host头没有匹配到任意一个主机名,或者请求中根本没有包含这个头,那nginx会将这个请求分发到默认的虚拟主机。在以上配置中,第一个被列出的虚拟主机即nginx的默认虚拟主机——这是nginx的标准默认行为。如果不想第一个虚拟主机成为默认主机,可以显式地在"<literal>listen</literal>"指令中设置"<literal>default_server</literal>"参数: | 44 在这个配置中,nginx仅仅检查请求的<header>Host</header>头以决定该请求应由哪个虚拟主机来处理。如果Host头没有匹配任意一个虚拟主机,或者请求中根本没有包含Host头,那nginx会将请求分发到定义在此端口上的默认虚拟主机。在以上配置中,第一个被列出的虚拟主机即nginx的默认虚拟主机——这是nginx的默认行为。而且,可以显式地设置某个主机为默认虚拟主机,即在"<literal>listen</literal>"指令中设置"<literal>default_server</literal>"参数: |
38 | 45 |
39 <programlisting> | 46 <programlisting> |
40 server { | 47 server { |
41 listen 80 <b>default_server</b>; | 48 listen 80 <b>default_server</b>; |
42 server_name nginx.net www.nginx.net; | 49 server_name example.net www.example.net; |
43 ... | 50 ... |
44 } | 51 } |
45 </programlisting> | 52 </programlisting> |
46 | 53 |
47 <note> | 54 <note> |
48 "<literal>default_server</literal>"参数从0.8.21版开始使用。在之前的版本中,需要使用"<literal>default</literal>"参数代替。 | 55 "<literal>default_server</literal>"参数从0.8.21版开始可用。在之前的版本中,应该使用"<literal>default</literal>"参数代替。 |
49 </note> | 56 </note> |
50 | 57 |
51 请注意"<literal>default_server</literal>"是监听端口的属性,而不是主机名的属性。后面会对此有更多介绍。 | 58 请注意"<literal>default_server</literal>"是监听端口的属性,而不是主机名的属性。后面会对此有更多介绍。 |
52 </para> | 59 </para> |
53 | 60 |
56 | 63 |
57 <section id="how_to_prevent_undefined_server_names" | 64 <section id="how_to_prevent_undefined_server_names" |
58 name="如何防止处理未定义主机名的请求"> | 65 name="如何防止处理未定义主机名的请求"> |
59 | 66 |
60 <para> | 67 <para> |
61 如果不想处理未定义<header>Host</header>头的请求,可以定义如下主机,以丢弃这些请求: | 68 如果不允许请求中缺少<header>Host</header>头,可以定义如下主机,丢弃这些请求: |
62 | 69 |
63 <programlisting> | 70 <programlisting> |
64 server { | 71 server { |
65 listen 80; | 72 listen 80; |
66 server_name ""; | 73 server_name ""; |
67 return 444; | 74 return 444; |
68 } | 75 } |
69 </programlisting> | 76 </programlisting> |
70 | 77 |
71 在这里,我们设置主机名为空字符串以匹配未定义<header>Host</header>头的请求,而且返回了一个nginx特有的,非http标准的返回码444,它可以用来关闭连接。从0.8.48版本开始,这已成为主机名的默认设置,所以<literal>server_name ""</literal>可以省略。而之前的版本使用机器的<i>hostname</i>作为默认主机名。 | 78 在这里,我们设置主机名为空字符串以匹配未定义<header>Host</header>头的请求,而且返回了一个nginx特有的,非http标准的返回码444,它可以用来关闭连接。 |
79 <note>从0.8.48版本开始,这已成为主机名的默认设置,所以可以省略<literal>server_name ""</literal>。而之前的版本使用机器的<i>hostname</i>作为主机名的默认值。</note> | |
72 </para> | 80 </para> |
73 | 81 |
74 </section> | 82 </section> |
75 | 83 |
76 | 84 |
80 <para> | 88 <para> |
81 下面让我们来看一个复杂点的配置,在这个配置里,有几个虚拟主机在不同的地址上监听: | 89 下面让我们来看一个复杂点的配置,在这个配置里,有几个虚拟主机在不同的地址上监听: |
82 | 90 |
83 <programlisting> | 91 <programlisting> |
84 server { | 92 server { |
85 listen 192.168.1.1:80; | 93 listen 192.168.1.1:80; |
86 server_name nginx.org www.nginx.org; | 94 server_name example.org www.example.org; |
87 ... | 95 ... |
88 } | 96 } |
89 | 97 |
90 server { | 98 server { |
91 listen 192.168.1.1:80; | 99 listen 192.168.1.1:80; |
92 server_name nginx.net www.nginx.net; | 100 server_name example.net www.example.net; |
93 ... | 101 ... |
94 } | 102 } |
95 | 103 |
96 server { | 104 server { |
97 listen 192.168.1.2:80; | 105 listen 192.168.1.2:80; |
98 server_name nginx.com www.nginx.com; | 106 server_name example.com www.example.com; |
99 ... | 107 ... |
100 } | 108 } |
101 </programlisting> | 109 </programlisting> |
102 | 110 |
103 这个配置中,nginx根据"<literal>server</literal>"配置块中的"<literal>listen</literal>"指令首先测试请求的IP地址和端口是否匹配某个定义的值。如果匹配成功,则继续测试请求的Host头是否匹配这个块中的"<literal>server_name</literal>"的值。如果主机名匹配失败,这个请求将被交给默认的虚拟主机处理。例如,一个从192.168.1.1:80端口收到的访问<literal>www.nginx.com</literal>的请求将被监听192.168.1.1:80端口的默认服务器处理,本例中就是第一个服务器,因为这个端口上没有定义域名为<literal>www.nginx.com</literal>的服务器。 | 111 这个配置中,nginx首先测试请求的IP地址和端口是否匹配某个<link doc="ngx_http_core_module.xml" id="server"/>配置块中的<link doc="ngx_http_core_module.xml" id="listen"/>指令配置。接着nginx继续测试请求的Host头是否匹配这个<link doc="ngx_http_core_module.xml" id="server"/>块中的某个<link doc="ngx_http_core_module.xml" id="server_name"/>的值。如果主机名没有找到,nginx将把这个请求交给默认虚拟主机处理。例如,一个从192.168.1.1:80端口收到的访问<literal>www.example.com</literal>的请求将被监听192.168.1.1:80端口的默认虚拟主机处理,本例中就是第一个服务器,因为这个端口上没有定义名为<literal>www.example.com</literal>的虚拟主机。 |
104 </para> | 112 </para> |
105 | 113 |
106 <para> | 114 <para> |
107 之前已经提到默认服务器是监听端口的属性,所以不同的监听端口可以设置不同的默认服务器: | 115 默认服务器是监听端口的属性,所以不同的监听端口可以设置不同的默认服务器: |
108 | 116 |
109 <programlisting> | 117 <programlisting> |
110 server { | 118 server { |
111 listen 192.168.1.1:80; | 119 listen 192.168.1.1:80; |
112 server_name nginx.org www.nginx.org; | 120 server_name example.org www.example.org; |
113 ... | 121 ... |
114 } | 122 } |
115 | 123 |
116 server { | 124 server { |
117 listen 192.168.1.1:80 default_server; | 125 listen 192.168.1.1:80 <b>default_server</b>; |
118 server_name nginx.net www.nginx.net; | 126 server_name example.net www.example.net; |
119 ... | 127 ... |
120 } | 128 } |
121 | 129 |
122 server { | 130 server { |
123 listen 192.168.1.2:80 default_server; | 131 listen 192.168.1.2:80 <b>default_server</b>; |
124 server_name nginx.com www.nginx.com; | 132 server_name example.com www.example.com; |
125 ... | 133 ... |
126 } | 134 } |
127 </programlisting> | 135 </programlisting> |
128 </para> | 136 </para> |
129 | 137 |
132 | 140 |
133 <section id="simple_php_site_configuration" | 141 <section id="simple_php_site_configuration" |
134 name="一个简单PHP站点配置"> | 142 name="一个简单PHP站点配置"> |
135 | 143 |
136 <para> | 144 <para> |
137 现在让我们来看一下,在一个典型的,简单的PHP站点中,nginx怎样为一个请求选择<i>location</i>来处理: | 145 现在我们来看在一个典型的,简单的PHP站点中,nginx怎样为一个请求选择<i>location</i>来处理: |
138 | 146 |
139 <programlisting> | 147 <programlisting> |
140 server { | 148 server { |
141 listen 80; | 149 listen 80; |
142 server_name nginx.org www.nginx.org; | 150 server_name example.org www.example.org; |
143 root /data/www; | 151 root /data/www; |
144 | 152 |
145 location / { | 153 location / { |
146 index index.html index.php; | 154 index index.html index.php; |
147 } | 155 } |
148 | 156 |
149 location ~* \.(gif|jpg|png)$ { | 157 location ~* \.(gif|jpg|png)$ { |
150 expires 30d; | 158 expires 30d; |
151 } | 159 } |
152 | 160 |
153 location ~ \.php$ { | 161 location ~ \.php$ { |
154 fastcgi_pass localhost:9000; | 162 fastcgi_pass localhost:9000; |
155 fastcgi_param SCRIPT_FILENAME | 163 fastcgi_param SCRIPT_FILENAME |
156 $document_root$fastcgi_script_name; | 164 $document_root$fastcgi_script_name; |
157 include fastcgi_params; | 165 include fastcgi_params; |
158 } | 166 } |
159 } | 167 } |
160 </programlisting> | 168 </programlisting> |
161 </para> | 169 </para> |
162 | 170 |
163 <para> | 171 <para> |
164 第一步,nginx使用字符串匹配找出最准确的location,这一步nginx会忽略location在配置文件出现的顺序。上面的配置中,只有唯一一个非正则匹配的location,也就是"<literal>/</literal>",它可以匹配任意的请求,一般作为最后一个选择。第二步,nginx会继续匹配正则表达式的location,匹配到第一个正则表达式后停止搜索。匹配到的location将被使用。正则表达式的匹配,按照配置中的顺序进行,出现在前的优先匹配。如果没有匹配到正则表达式,则使用第一步匹配的结果。 | 172 首先,nginx使用前缀匹配找出最准确的location,这一步nginx会忽略location在配置文件出现的顺序。上面的配置中,唯一的前缀匹配location是"<literal>/</literal>",而且因为它可以匹配任意的请求,所以被作为最后一个选择。接着,nginx继续按照配置中的顺序依次匹配正则表达式的location,匹配到第一个正则表达式后停止搜索。匹配到的location将被使用。如果没有匹配到正则表达式的location,则使用刚刚找到的最准确的前缀匹配的location。 |
165 </para> | 173 </para> |
166 | 174 |
167 <para> | 175 <para> |
168 请注意所有location匹配测试只使用请求的URI部分,而不使用参数部分。这是因为参数在请求串中顺序是任意的,比如: | 176 请注意所有location匹配测试只使用请求的URI部分,而不使用参数部分。这是因为写参数的方法很多,比如: |
169 | 177 |
170 <programlisting> | 178 <programlisting> |
171 /index.php?user=john&page=1 | 179 /index.php?user=john&page=1 |
172 /index.php?page=1&user=john | 180 /index.php?page=1&user=john |
173 </programlisting> | 181 </programlisting> |
178 /index.php?page=1&something+else&user=john | 186 /index.php?page=1&something+else&user=john |
179 </programlisting> | 187 </programlisting> |
180 </para> | 188 </para> |
181 | 189 |
182 <para> | 190 <para> |
183 现在让我们来看一下使用上面的配置进来的请求是怎样被处理的: | 191 现在让我们来看使用上面的配置,请求是怎样被处理的: |
184 | 192 |
185 <list type="bullet"> | 193 <list type="bullet" compact="no"> |
186 | 194 |
187 <listitem> | 195 <listitem> |
188 <para> | 196 请求"<literal>/logo.gif</literal>"首先匹配上location "<literal>/</literal>",然后匹配上正则表达式"<literal>\.(gif|jpg|png)$</literal>"。因此,它将被后者处理。根据"<literal>root /data/www</literal>"指令,nginx将请求映射到文件<path>/data/www/logo.gif</path>",并发送这个文件到客户端。 |
189 请求"<literal>/logo.gif</literal>"首先匹配上location "<literal>/</literal>",然后匹配上正则表达式"<literal>\.(gif|jpg|png)$</literal>"。因此,它将被后匹配上的location处理。根据"<literal>root /data/www</literal>"指令,nginx将请求映射到文件"<literal>/data/www/logo.gif</literal>",并发送这个文件到客户端。 | 197 </listitem> |
190 </para> | 198 |
191 </listitem> | 199 <listitem> |
192 | 200 请求"<literal>/index.php</literal>"首先也匹配上location "<literal>/</literal>",然后匹配上正则表达式"<literal>\.(php)$</literal>"。 因此,它将被后者处理,进而被发送到监听在localhost:9000的FastCGI服务器。<link doc="ngx_http_fastcgi_module.xml" id="fastcgi_param"/>指令将FastCGI的参数<literal>SCRIPT_FILENAME</literal>的值设置为"<literal>/data/www/index.php</literal>",接着FastCGI服务器执行这个文件。变量<var>$document_root</var>等于<link doc="ngx_http_core_module.xml" id="root"/>指令设置的值,变量<var>$fastcgi_script_name</var>的值是请求的uri,"<literal>/index.php</literal>"。 |
193 <listitem> | 201 </listitem> |
194 <para> | 202 |
195 请求"<literal>/index.php</literal>"首先也匹配上location "<literal>/</literal>",然后匹配上正则表达式"<literal>\.(php)$</literal>"。 因此,它将被后匹配上的location处理,会被发送到一个监听在localhost:9000的FastCGI服务器。"<literal>fastcgi_param</literal>"指令将FastCGI的参数SCRIPT_FILENAME的值设置为"<literal>/data/www/index.php</literal>",接着FastCGI服务器将执行这个文件。变量$document_root等于"<literal>root</literal>"指令设置的值,变量$fastcgi_script_name的值等于请求的uri,"<literal>/index.php</literal>"。 | 203 <listitem> |
196 </para> | 204 请求"<literal>/about.html</literal>"仅能匹配上location "<literal>/</literal>",因此,它将使用此location进行处理。根据"<literal>root /data/www</literal>"指令,nginx将请求映射到文件"<path>/data/www/about.html</path>",并发送这个文件到客户端。 |
197 </listitem> | 205 </listitem> |
198 | 206 |
199 <listitem> | 207 <listitem> |
200 <para> | 208 请求"<literal>/</literal>"的处理更为复杂。它仅能匹配上location "<literal>/</literal>",因此,它将使用此location进行处理。然后,<link doc="ngx_http_index_module.xml" id="index"/>指令使用它的参数和"<literal>root /data/www</literal>"指令所组成的文件路径来检测对应的文件是否存在。如果文件<path>/data/www/index.html</path>不存在,而<path>/data/www/index.php</path>存在,此指令将执行一次内部重定向到"<literal>/index.php</literal>",接着nginx将重新寻找匹配"<literal>/index.php</literal>"的location,就好像这次请求是从客户端发过来一样。正如我们之前看到的那样,这个重定向的请求最终交给FastCGI服务器来处理。 |
201 请求"<literal>/about.html</literal>"仅能匹配上location "<literal>/</literal>",因此,它将使用此location进行处理。根据"<literal>root /data/www</literal>"指令,nginx将请求映射到文件"<literal>/data/www/about.html</literal>",并发送这个文件到客户端。 | |
202 </para> | |
203 </listitem> | |
204 | |
205 <listitem> | |
206 <para> | |
207 请求"<literal>/</literal>"的处理更为复杂。它仅能匹配上location "<literal>/</literal>",因此,它将使用此location进行处理。然后,"<literal>index</literal>"指令使用它的参数和"<literal>root /data/www</literal>"指令所组成的文件路径来检测对应的文件是否存在。如果文件"<literal>/data/www/index.php</literal>"存在,"<literal>index</literal>"指令将执行一次内部重定向到"<literal>/index.php</literal>",接着nginx将重新寻找匹配"<literal>/index.php</literal>"的location,就好像这次请求是从客户端发过来一样。正如我们之前看到的那样,这个重定向的请求最终交给FastCGI服务器来处理。 | |
208 </para> | |
209 </listitem> | 209 </listitem> |
210 | 210 |
211 </list> | 211 </list> |
212 </para> | 212 </para> |
213 | 213 |