diff xml/cn/docs/http/request_processing.xml @ 558:149f54c158f0

Added initial translation in simplified Chinese submitted by the Server Platforms Team at Taobao.com.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 28 Jun 2012 10:27:07 +0000
parents
children 130fad6dc1b4
line wrap: on
line diff
new file mode 100644
--- /dev/null
+++ b/xml/cn/docs/http/request_processing.xml
@@ -0,0 +1,216 @@
+<!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
+
+<article name="Nginx如何处理一个请求"
+         link="/cn/docs/http/request_processing.html"
+         lang="cn"
+         author="Igor Sysoev"
+         editor="Brian Mercer">
+
+
+<section name="基于名字的虚拟主机">
+
+<para>
+Nginx首先选定由哪一个<i>虚拟主机</i>来处理请求。让我们从一个简单的配置(其中全部3个虚拟主机都在端口*:80上监听)开始:
+
+<programlisting>
+server {
+    listen       80;
+    server_name  nginx.org  www.nginx.org;
+    ...
+}
+
+server {
+    listen       80;
+    server_name  nginx.net  www.nginx.net;
+    ...
+}
+
+server {
+    listen       80;
+    server_name  nginx.com  www.nginx.com;
+    ...
+}
+</programlisting>
+</para>
+
+<para>
+在这个配置中,nginx仅仅检查请求的Host头以决定该请求应由哪个虚拟主机来处理。如果Host头没有匹配到任意一个主机名,或者请求中根本没有包含这个头,那nginx会将这个请求分发到默认的虚拟主机。在以上配置中,第一个被列出的虚拟主机即nginx的默认虚拟主机——这是nginx的标准默认行为。如果不想第一个虚拟主机成为默认主机,可以显式地在"<literal>listen</literal>"指令中设置"<literal>default_server</literal>"参数:
+
+<programlisting>
+server {
+    listen       80  <b>default_server</b>;
+    server_name  nginx.net  www.nginx.net;
+    ...
+}
+</programlisting>
+
+<note>
+"<literal>default_server</literal>"参数从0.8.21版开始使用。在之前的版本中,需要使用"<literal>default</literal>"参数代替。
+</note>
+
+请注意"<literal>default_server</literal>"是监听端口的属性,而不是主机名的属性。后面会对此有更多介绍。
+</para>
+
+</section>
+
+
+<section id="how_to_prevent_undefined_server_names"
+        name="如何防止处理未定义主机名的请求">
+
+<para>
+如果不想处理未定义<header>Host</header>头的请求,可以定义如下主机,以丢弃这些请求:
+
+<programlisting>
+server {
+    listen       80;
+    server_name  "";
+    return       444;
+}
+</programlisting>
+
+在这里,我们设置主机名为空字符串以匹配未定义<header>Host</header>头的请求,而且返回了一个nginx特有的,非http标准的返回码444,它可以用来关闭连接。从0.8.48版本开始,这已成为主机名的默认设置,所以<literal>server_name ""</literal>可以省略。而之前的版本使用机器的<i>hostname</i>作为默认主机名。
+</para>
+
+</section>
+
+
+<section id="mixed_name_ip_based_servers"
+        name="基于域名和IP混合的虚拟主机">
+
+<para>
+下面让我们来看一个复杂点的配置,在这个配置里,有几个虚拟主机在不同的地址上监听:
+
+<programlisting>
+server {
+    listen       192.168.1.1:80;
+    server_name  nginx.org  www.nginx.org;
+    ...
+}
+
+server {
+    listen       192.168.1.1:80;
+    server_name  nginx.net  www.nginx.net;
+    ...
+}
+
+server {
+    listen       192.168.1.2:80;
+    server_name  nginx.com  www.nginx.com;
+    ...
+}
+</programlisting>
+
+这个配置中,nginx根据"<literal>server</literal>"配置块中的"<literal>listen</literal>"指令首先测试请求的IP地址和端口是否匹配某个定义的值。如果匹配成功,则继续测试请求的Host头是否匹配这个块中的"<literal>server_name</literal>"的值。如果主机名匹配失败,这个请求将被交给默认的虚拟主机处理。例如,一个从192.168.1.1:80端口收到的访问<url>www.nginx.com</url>的请求将被监听192.168.1.1:80端口的默认服务器处理,本例中就是第一个服务器,因为这个端口上没有定义域名为<url>www.nginx.com</url>的服务器。
+</para>
+
+<para>
+之前已经提到默认服务器是监听端口的属性,所以不同的监听端口可以设置不同的默认服务器:
+
+<programlisting>
+server {
+    listen        192.168.1.1:80;
+    server_name   nginx.org  www.nginx.org;
+    ...
+}
+
+server {
+    listen        192.168.1.1:80  default_server;
+    server_name   nginx.net  www.nginx.net;
+    ...
+}
+
+server {
+    listen        192.168.1.2:80  default_server;
+    server_name   nginx.com  www.nginx.com;
+    ...
+}
+</programlisting>
+</para>
+
+</section>
+
+
+<section id="simple_php_site_configuration"
+        name="一个简单PHP站点配置">
+
+<para>
+现在让我们来看一下,在一个典型的,简单的PHP站点中,nginx怎样为一个请求选择<i>location</i>来处理:
+
+<programlisting>
+server {
+    listen        80;
+    server_name   nginx.org  www.nginx.org;
+    root          /data/www;
+
+    location / {
+        index     index.html  index.php;
+    }
+
+    location ~* \.(gif|jpg|png)$ {
+        expires   30d;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass   localhost:9000;
+        fastcgi_param  SCRIPT_FILENAME
+                       $document_root$fastcgi_script_name;
+        include        fastcgi_params;
+    }
+}
+</programlisting>
+</para>
+
+<para>
+第一步,nginx使用字符串匹配找出最准确的location,这一步nginx会忽略location在配置文件出现的顺序。上面的配置中,只有唯一一个非正则匹配的location,也就是"<literal>/</literal>",它可以匹配任意的请求,一般作为最后一个选择。第二步,nginx会继续匹配正则表达式的location,匹配到第一个正则表达式后停止搜索。匹配到的location将被使用。正则表达式的匹配,按照配置中的顺序进行,出现在前的优先匹配。如果没有匹配到正则表达式,则使用第一步匹配的结果。
+</para>
+
+<para>
+请注意所有location匹配测试只使用请求的URI部分,而不使用参数部分。这是因为参数在请求串中顺序是任意的,比如:
+
+<programlisting>
+/index.php?user=john&amp;page=1
+/index.php?page=1&amp;user=john
+</programlisting>
+
+除此以外,任何人在请求串中都可以随意添加字符串:
+
+<programlisting>
+/index.php?page=1&amp;something+else&amp;user=john
+</programlisting>
+</para>
+
+<para>
+现在让我们来看一下使用上面的配置进来的请求是怎样被处理的:
+
+<list type="bullet">
+
+<listitem>
+<para>
+请求"<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>",并发送这个文件到客户端。
+</para>
+</listitem>
+
+<listitem>
+<para>
+请求"<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>"。
+</para>
+</listitem>
+
+<listitem>
+<para>
+请求"<literal>/about.html</literal>"仅能匹配上location "<literal>/</literal>",因此,它将使用此location进行处理。根据"<literal>root /data/www</literal>"指令,nginx将请求映射到文件"<literal>/data/www/about.html</literal>",并发送这个文件到客户端。
+</para>
+</listitem>
+
+<listitem>
+<para>
+请求"<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服务器来处理。
+</para>
+</listitem>
+
+</list>
+</para>
+
+</section>
+
+</article>