Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 310:86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
fastcgi_cache_lock, and fastcgi_cache_lock_timeout directives.
| author | Ruslan Ermilov <ru@nginx.com> |
|---|---|
| date | Thu, 12 Jan 2012 12:22:06 +0000 |
| parents | df728215db07 |
| children | 1fb1c077658b |
| rev | line source |
|---|---|
|
222
bfe3eff81d04
Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents:
135
diff
changeset
|
1 <?xml version="1.0"?> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
4 |
| 295 | 5 <module name="Модуль ngx_http_fastcgi_module" |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
6 link="/ru/docs/http/ngx_http_fastcgi_module.html" |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
7 lang="ru"> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 |
|
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
9 <section id="summary"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
10 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 <para> |
| 295 | 12 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать |
| 13 запросы FastCGI-серверу. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
15 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
18 |
| 295 | 19 <section id="example" name="Пример конфигурации"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
20 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
21 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
22 <example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
23 location / { |
| 295 | 24 fastcgi_pass localhost:9000; |
| 25 fastcgi_index index.php; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
| 295 | 27 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; |
| 28 fastcgi_param QUERY_STRING $query_string; | |
| 29 fastcgi_param REQUEST_METHOD $request_method; | |
| 30 fastcgi_param CONTENT_TYPE $content_type; | |
| 31 fastcgi_param CONTENT_LENGTH $content_length; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
32 } |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
35 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
36 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 |
| 295 | 39 <section id="directives" name="Директивы"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 <directive name="fastcgi_buffer_size"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
42 <syntax><value>размер</value></syntax> |
| 295 | 43 <default>4k|8k</default> |
| 44 <context>http</context> | |
| 45 <context>server</context> | |
| 46 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
47 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
48 <para> |
| 295 | 49 Задаёт <value>размер</value> буфера, в который будет читаться |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
50 первая часть ответа, получаемого от FastCGI-сервера. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
51 В этой части ответа находится, как правило, небольшой заголовок ответа. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
52 По умолчанию размер буфера равен размеру одного буфера в директиве |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
53 <link id="fastcgi_buffers"/>, однако его можно сделать меньше. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
54 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
55 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
56 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
57 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
58 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
59 <directive name="fastcgi_buffers"> |
| 271 | 60 <syntax><value>число</value> <value>размер</value></syntax> |
| 295 | 61 <default>8 4k|8k</default> |
| 62 <context>http</context> | |
| 63 <context>server</context> | |
| 64 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
65 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
66 <para> |
| 295 | 67 Задаёт <value>число</value> и <value>размер</value> буферов |
| 68 для одного соединения, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 в которые будет читаться ответ, получаемый от FastCGI-сервера. |
| 295 | 70 По умолчанию размер одного буфера равен размеру страницы. |
| 71 В зависимости от платформы это или 4K, или 8K. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
72 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
73 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
74 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
75 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
76 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
77 <directive name="fastcgi_cache"> |
| 271 | 78 <syntax><value>зона</value> | <literal>off</literal></syntax> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
79 <default>off</default> |
| 295 | 80 <context>http</context> |
| 81 <context>server</context> | |
| 82 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
83 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
84 <para> |
| 295 | 85 Задаёт зону для кэширования. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
86 Одна и та же зона может использоваться в нескольких местах. |
| 295 | 87 Параметр <literal>off</literal> запрещает кэширование, унаследованное |
| 88 с предыдущего уровня конфигурации. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
89 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
90 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
91 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
92 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
93 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
94 <directive name="fastcgi_cache_bypass"> |
| 271 | 95 <syntax><value>строка</value> ...</syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
96 <default/> |
| 295 | 97 <context>http</context> |
| 98 <context>server</context> | |
| 99 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
100 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
101 <para> |
| 295 | 102 Задаёт условия, при которых ответ не будет браться из кэша. |
| 103 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 то ответ не берётся из кэша: |
| 98 | 105 <example> |
| 295 | 106 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment; |
| 107 fastcgi_cache_bypass $http_pragma $http_authorization; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
108 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
109 Можно использовать совместно с директивой <link id="fastcgi_no_cache"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
112 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
113 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
114 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 <directive name="fastcgi_cache_key"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
116 <syntax><value>строка</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
117 <default/> |
| 295 | 118 <context>http</context> |
| 119 <context>server</context> | |
| 120 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
121 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
122 <para> |
| 295 | 123 Задаёт ключ для кэширования, например, |
| 98 | 124 <example> |
| 295 | 125 fastcgi_cache_key localhost:9000$request_uri; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
126 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
127 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
128 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
129 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 |
|
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
132 <directive name="fastcgi_cache_lock"> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
133 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
134 <default>off</default> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
135 <context>http</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
136 <context>server</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
137 <context>location</context> |
|
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
138 <appeared-in>1.1.12</appeared-in> |
|
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
139 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
140 <para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
141 Если включено, одновременно только одному запросу будет позволено |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
142 заполнить новый элемент кэша, идентифицируемый согласно директиве |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
143 <link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер. |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
144 Остальные запросы этого же элемента будут либо ожидать |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
145 появления ответа в кэше, либо освобождения блокировки |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
146 этого элемента, в течение времени, заданного директивой |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
147 <link id="fastcgi_cache_lock_timeout"/>. |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
148 </para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
149 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
150 </directive> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
151 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
152 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
153 <directive name="fastcgi_cache_lock_timeout"> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
154 <syntax><value>время</value></syntax> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
155 <default>5s</default> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
156 <context>http</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
157 <context>server</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
158 <context>location</context> |
|
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
159 <appeared-in>1.1.12</appeared-in> |
|
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
160 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
161 <para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
162 Задаёт таймаут для <link id="fastcgi_cache_lock"/>. |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
163 </para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
164 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
165 </directive> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
166 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
167 |
| 295 | 168 <directive name="fastcgi_cache_min_uses"> |
| 169 <syntax><value>число</value></syntax> | |
| 170 <default>1</default> | |
| 171 <context>http</context> | |
| 172 <context>server</context> | |
| 173 <context>location</context> | |
| 174 | |
| 175 <para> | |
| 176 Задаёт <value>число</value> запросов, после которого ответ будет закэширован. | |
| 177 </para> | |
| 178 | |
| 179 </directive> | |
| 180 | |
| 181 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
182 <directive name="fastcgi_cache_path"> |
| 271 | 183 <syntax> |
| 184 <value>путь</value> | |
| 185 [<literal>levels</literal>=<value>уровни</value>] | |
| 295 | 186 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> |
| 271 | 187 [<literal>inactive</literal>=<value>время</value>] |
| 188 [<literal>max_size</literal>=<value>размер</value>]</syntax> | |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
189 <default/> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
190 <context>http</context> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
191 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
192 <para> |
| 295 | 193 Задаёт путь и другие параметры кэша. |
| 194 Данные кэша хранятся в файлах. | |
| 195 Ключом и именем файла в кэше является результат функции MD5 | |
| 196 от проксированного URL. | |
| 197 Параметр <literal>levels</literal> задаёт уровни иерархии кэша, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
198 например, при использовании |
| 98 | 199 <example> |
| 295 | 200 fastcgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
201 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
202 имена файлов в кэше будут такого вида: |
| 98 | 203 <example> |
| 295 | 204 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
205 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
206 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
207 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
208 <para> |
| 295 | 209 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
210 переименовывается. Начиная с версии 0.8.9, временные файлы и кэш |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
211 могут располагаться на разных файловых системах, но нужно учитывать, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
212 что в этом случае вместо дешёвой операции переименовывания в пределах |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
213 одной файловой системы файл копируется с одной файловой системы на другую. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
214 Поэтому лучше, если кэш будет находиться на той же файловой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
215 системе, что и каталог с временными файлами, задаваемый директивой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
216 <link id="fastcgi_temp_path"/> для данного location. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
217 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
218 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
219 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
220 Кроме того, все активные ключи и информация о данных хранятся в разделяемой |
| 295 | 221 памяти — зоне, <value>имя</value> и <value>размер</value> которой |
| 222 задаются параметром <literal>keys_zone</literal>. | |
| 285 | 223 Если к данным кэша не обращаются в течение времени, заданного параметром |
| 295 | 224 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. |
| 225 По умолчанию <literal>inactive</literal> равен 10 минутам. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
227 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
228 <para> |
| 295 | 229 Специальный процесс “cache manager” следит за максимальным размером кэша, |
| 230 заданным параметром <literal>max_size</literal>, и при превышении | |
| 231 его размеров удаляет самые невостребованные данные. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
232 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
233 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
234 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
235 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
236 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
237 <directive name="fastcgi_cache_use_stale"> |
| 271 | 238 <syntax> |
| 239 <literal>error</literal> | | |
| 240 <literal>timeout</literal> | | |
| 241 <literal>invalid_header</literal> | | |
| 242 <literal>updating</literal> | | |
| 243 <literal>http_500</literal> | | |
| 244 <literal>http_503</literal> | | |
| 245 <literal>http_404</literal> | | |
| 246 <literal>off</literal> | |
| 247 ...</syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
248 <default>off</default> |
| 295 | 249 <context>http</context> |
| 250 <context>server</context> | |
| 251 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
252 |
| 295 | 253 <para> |
| 254 Определяет, в каких случаях можно использовать устаревший закэшированный ответ, | |
| 255 если при работе с FastCGI-сервером возникла ошибка. | |
| 256 Параметры директивы совпадают с параметрами | |
| 257 директивы <link id="fastcgi_next_upstream"/>. | |
| 258 Кроме того, дополнительный параметр <literal>updating</literal> | |
| 259 разрешает использовать устаревший закэшированный ответ, | |
| 260 если на данный момент он уже обновляется. | |
| 261 </para> | |
| 262 | |
| 263 </directive> | |
| 264 | |
| 265 | |
| 266 <directive name="fastcgi_cache_valid"> | |
| 267 <syntax>[<value>код</value> ...] <value>время</value></syntax> | |
| 268 <default/> | |
| 269 <context>http</context> | |
| 270 <context>server</context> | |
| 271 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
272 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
273 <para> |
| 295 | 274 Задаёт время кэширования для разных кодов ответа. |
| 275 Например, директивы | |
| 276 <example> | |
| 277 fastcgi_cache_valid 200 302 10m; | |
| 278 fastcgi_cache_valid 404 1m; | |
| 279 </example> | |
| 280 задают время кэширования 10 минут для ответов с кодами 200 и 302, | |
| 281 и 1 минуту для ответов с кодом 404. | |
| 282 </para> | |
| 283 | |
| 284 <para> | |
| 285 Если указано только <value>время</value> кэширования, | |
| 286 <example> | |
| 287 fastcgi_cache_valid 5m; | |
| 288 </example> | |
| 289 то кэшируются только ответы 200, 301 и 302. | |
| 290 </para> | |
| 291 | |
| 292 <para> | |
| 293 Кроме того, можно кэшировать любые ответы с помощью параметра | |
| 294 <literal>any</literal>: | |
| 295 <example> | |
| 296 fastcgi_cache_valid 200 302 10m; | |
| 297 fastcgi_cache_valid 301 1h; | |
| 298 fastcgi_cache_valid any 1m; | |
| 299 </example> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
300 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
301 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
302 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
303 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
304 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
305 <directive name="fastcgi_connect_timeout"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
306 <syntax><value>время</value></syntax> |
| 295 | 307 <default>60s</default> |
| 308 <context>http</context> | |
| 309 <context>server</context> | |
| 310 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
311 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
312 <para> |
| 295 | 313 Задаёт таймаут для установления соединения с FastCGI-сервером. |
| 314 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
315 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
316 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
317 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
318 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
319 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
320 <directive name="fastcgi_hide_header"> |
| 295 | 321 <syntax><value>поле</value></syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
322 <default/> |
| 295 | 323 <context>http</context> |
| 324 <context>server</context> | |
| 325 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
326 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
327 <para> |
| 295 | 328 По умолчанию |
| 329 nginx не передаёт клиенту поля заголовка <header>Status</header> и | |
| 330 <header>X-Accel-...</header> из ответа FastCGI-сервера. | |
| 331 Директива <literal>fastcgi_hide_header</literal> задаёт дополнительные поля, | |
| 332 которые не будут передаваться. | |
| 333 Если же передачу полей нужно разрешить, можно воспользоваться | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
334 директивой <link id="fastcgi_pass_header"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
335 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
336 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
337 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
339 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
340 <directive name="fastcgi_ignore_client_abort"> |
| 271 | 341 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
342 <default>off</default> |
| 295 | 343 <context>http</context> |
| 344 <context>server</context> | |
| 345 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
346 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
347 <para> |
| 295 | 348 Определяет, закрывать ли соединение с FastCGI-сервером |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
349 в случае, если клиент закрыл соединение, не дождавшись ответа. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
350 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
351 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
352 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
353 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
354 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
355 <directive name="fastcgi_ignore_headers"> |
| 295 | 356 <syntax><value>поле</value> ...</syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
357 <default/> |
| 295 | 358 <context>http</context> |
| 359 <context>server</context> | |
| 360 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
361 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
362 <para> |
| 295 | 363 Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера. |
| 364 В директиве можно указать поля <header>X-Accel-Redirect</header>, | |
| 365 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), | |
| 366 <header>X-Accel-Buffering</header> (1.1.6), | |
| 367 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, | |
| 368 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44). | |
| 369 </para> | |
| 370 | |
| 371 </directive> | |
| 372 | |
| 373 | |
| 374 <directive name="fastcgi_index"> | |
| 375 <syntax><value>имя</value></syntax> | |
| 376 <default/> | |
| 377 <context>http</context> | |
| 378 <context>server</context> | |
| 379 <context>location</context> | |
| 380 | |
| 381 <para> | |
| 382 Задаёт имя файла, который при создании переменной | |
| 383 <var>$fastcgi_script_name</var> будет добавляться после URI, | |
| 384 если URI заканчивается слэшом. | |
| 385 Например, при таких настройках | |
| 386 <example> | |
| 387 fastcgi_index index.php; | |
| 388 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; | |
| 389 </example> | |
| 390 и запросе “<literal>/page.php</literal>” | |
| 391 параметр <literal>SCRIPT_FILENAME</literal> будет равен | |
| 392 “<literal>/home/www/scripts/php/page.php</literal>”, | |
| 393 а при запросе “<literal>/</literal>”— | |
| 394 “<literal>/home/www/scripts/php/index.php</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
395 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
396 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
397 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
398 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
399 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
400 <directive name="fastcgi_intercept_errors"> |
| 271 | 401 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
402 <default>off</default> |
| 295 | 403 <context>http</context> |
| 404 <context>server</context> | |
| 405 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
406 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
407 <para> |
| 295 | 408 Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом |
| 409 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью | |
| 410 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>. | |
| 98 | 411 </para> |
| 412 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
413 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
414 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
415 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
416 <directive name="fastcgi_next_upstream"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
417 <syntax> |
| 271 | 418 <literal>error</literal> | |
| 419 <literal>timeout</literal> | | |
| 420 <literal>invalid_header</literal> | | |
| 421 <literal>http_500</literal> | | |
| 422 <literal>http_503</literal> | | |
| 423 <literal>http_404</literal> | | |
| 424 <literal>off</literal> | |
| 425 ...</syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
426 <default>error timeout</default> |
| 295 | 427 <context>http</context> |
| 428 <context>server</context> | |
| 429 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
430 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
431 <para> |
| 295 | 432 Определяет, в каких случаях запрос будет передан следующему серверу: |
| 433 <list type="tag"> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
434 |
| 295 | 435 <tag-name><literal>error</literal></tag-name> |
| 436 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или | |
| 437 чтения заголовка ответа сервера;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
438 |
| 295 | 439 <tag-name><literal>timeout</literal></tag-name> |
| 440 <tag-desc>произошёл таймаут во время соединения с сервером, | |
| 441 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
442 |
| 295 | 443 <tag-name><literal>invalid_header</literal></tag-name> |
| 444 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
445 |
| 295 | 446 <tag-name><literal>http_500</literal></tag-name> |
| 447 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
448 |
| 295 | 449 <tag-name><literal>http_503</literal></tag-name> |
| 450 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
451 |
| 295 | 452 <tag-name><literal>http_404</literal></tag-name> |
| 453 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
454 |
| 295 | 455 <tag-name><literal>off</literal></tag-name> |
| 456 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
457 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
458 </list> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
459 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
460 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
461 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
462 Необходимо понимать, что передача запроса следующему серверу возможна |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
463 только при условии, что клиенту ещё ничего не передавалось. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
464 То есть, если ошибка или таймаут возникли в середине передачи ответа, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
465 то исправить это уже невозможно. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
466 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
467 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
468 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
469 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
470 |
| 295 | 471 <directive name="fastcgi_no_cache"> |
| 472 <syntax><value>строка</value> ...</syntax> | |
| 473 <default/> | |
| 474 <context>http</context> | |
| 475 <context>server</context> | |
| 476 <context>location</context> | |
| 477 | |
| 478 <para> | |
| 479 Задаёт условия, при которых ответ не будет сохраняться в кэш. | |
| 480 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, | |
| 481 то ответ не будет сохранён: | |
| 482 <example> | |
| 483 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment; | |
| 484 fastcgi_no_cache $http_pragma $http_authorization; | |
| 485 </example> | |
| 486 Можно использовать совместно с директивой <link id="fastcgi_cache_bypass"/>. | |
| 487 </para> | |
| 488 | |
| 489 </directive> | |
| 490 | |
| 491 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
492 <directive name="fastcgi_param"> |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
493 <syntax> |
| 271 | 494 <value>параметр</value> <value>значение</value> |
| 495 [<literal>if_not_empty</literal>]</syntax> | |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
496 <default/> |
| 295 | 497 <context>http</context> |
| 498 <context>server</context> | |
| 499 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
500 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
501 <para> |
| 295 | 502 Задаёт <value>параметр</value>, который будет передаваться FastCGI-серверу. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
503 В качестве значения можно использовать текст, переменные и их комбинации. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
504 Директивы наследуются с предыдущего уровня при условии, что на данном |
| 271 | 505 уровне не описаны свои директивы <literal>fastcgi_param</literal>. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
506 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
507 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
508 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
509 Ниже приведён пример минимально необходимых параметров для PHP: |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
510 <example> |
| 295 | 511 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; |
| 512 fastcgi_param QUERY_STRING $query_string; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
513 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
514 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
515 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
516 <para> |
| 295 | 517 Параметр <literal>SCRIPT_FILENAME</literal> используется в PHP для |
| 518 определения имени скрипта, а в параметре <literal>QUERY_STRING</literal> | |
| 519 передаются параметры запроса. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
520 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
521 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
522 <para> |
| 295 | 523 Если скрипты обрабатывают запросы <literal>POST</literal>, то нужны |
| 524 ещё три параметра: | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
525 <example> |
| 295 | 526 fastcgi_param REQUEST_METHOD $request_method; |
| 527 fastcgi_param CONTENT_TYPE $content_type; | |
| 528 fastcgi_param CONTENT_LENGTH $content_length; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
529 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
530 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
531 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
532 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
533 Если PHP был собран с параметром конфигурации |
| 271 | 534 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать |
| 295 | 535 параметр <literal>REDIRECT_STATUS</literal> со значением “200”: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
536 <example> |
| 295 | 537 fastcgi_param REDIRECT_STATUS 200; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
538 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
539 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
540 |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
541 <para> |
| 295 | 542 Если директива указана с <literal>if_not_empty</literal> (1.1.11), |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
543 то такой параметр с пустым значением передаваться на сервер не будет: |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
544 <example> |
| 295 | 545 fastcgi_param HTTPS $https if_not_empty; |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
546 </example> |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
547 </para> |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
548 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
549 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
550 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
551 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
552 <directive name="fastcgi_pass"> |
| 295 | 553 <syntax><value>адрес</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
554 <default/> |
| 295 | 555 <context>location</context> |
| 556 <context>if в location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
557 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
558 <para> |
| 295 | 559 Задаёт адрес FastCGI-сервера. |
| 560 Адрес может быть указан в виде доменного имени или адреса, и порта, например, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
561 <example> |
| 295 | 562 fastcgi_pass localhost:9000; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
563 </example> |
| 295 | 564 или в виде пути UNIX-сокета: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
565 <example> |
| 295 | 566 fastcgi_pass unix:/tmp/fastcgi.socket; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
567 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
568 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
569 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
570 <para> |
| 295 | 571 Если доменному имени соответствует несколько адресов, то все они будут |
| 572 использоваться по очереди (round-robin). | |
| 573 И, кроме того, адрес может быть | |
|
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
574 <link doc="ngx_http_upstream_module.xml">группой серверов</link>. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
575 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
576 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
577 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
578 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
579 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
580 <directive name="fastcgi_pass_header"> |
| 295 | 581 <syntax><value>поле</value></syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
582 <default/> |
| 295 | 583 <context>http</context> |
| 584 <context>server</context> | |
| 585 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
586 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
587 <para> |
| 295 | 588 Разрешает передавать от FastCGI-сервера клиенту |
| 589 <link id="fastcgi_hide_header">запрещённые для передачи</link> поля заголовка. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
590 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
591 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
592 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
593 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
594 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
595 <directive name="fastcgi_read_timeout"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
596 <syntax><value>время</value></syntax> |
| 295 | 597 <default>60s</default> |
| 598 <context>http</context> | |
| 599 <context>server</context> | |
| 600 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
601 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
602 <para> |
| 295 | 603 Задаёт таймаут при чтении ответа FastCGI-сервера. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
604 Таймаут устанавливается не на всю передачу ответа, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
605 а только между двумя операциями чтения. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
606 Если по истечении этого времени FastCGI-сервер ничего не передаст, |
| 295 | 607 соединение закрывается. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
608 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
609 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
610 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
611 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
612 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
613 <directive name="fastcgi_send_timeout"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
614 <syntax><value>время</value></syntax> |
| 295 | 615 <default>60s</default> |
| 616 <context>http</context> | |
| 617 <context>server</context> | |
| 618 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
619 |
| 98 | 620 <para> |
| 295 | 621 Задаёт таймаут при передаче запроса FastCGI-серверу. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
622 Таймаут устанавливается не на всю передачу запроса, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
623 а только между двумя операциями записи. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
624 Если по истечении этого времени FastCGI-сервер не примет новых данных, |
| 295 | 625 соединение закрывается. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
626 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
627 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
628 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
629 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
630 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
631 <directive name="fastcgi_split_path_info"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
632 <syntax><value>regex</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
633 <default/> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
634 <context>location</context> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
635 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
636 <para> |
| 295 | 637 Задаёт регулярное выражение, выделяющее значение для переменной |
| 638 <var>$fastcgi_path_info</var>. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
639 Регулярное выражение должно иметь два выделения, из которых первое |
| 295 | 640 становится значением переменной <var>$fastcgi_script_name</var>, |
| 641 а второе—значением переменной <var>$fastcgi_path_info</var>. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
642 Например, при таких настройках |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
643 <example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
644 location ~ ^(.+\.php)(.*)$ { |
| 295 | 645 fastcgi_split_path_info ^(.+\.php)(.*)$; |
| 646 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name; | |
| 647 fastcgi_param PATH_INFO $fastcgi_path_info; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
648 </example> |
| 295 | 649 и запросе “<literal>/show.php/article/0001</literal>” |
| 650 параметр <literal>SCRIPT_FILENAME</literal> будет равен | |
| 651 “<literal>/path/to/php/show.php</literal>”, а параметр | |
| 652 <literal>PATH_INFO</literal>—“<literal>/article/0001</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
653 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
654 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
655 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
656 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
657 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
658 <directive name="fastcgi_store"> |
| 271 | 659 <syntax> |
| 295 | 660 <literal>on</literal> | |
| 661 <literal>off</literal> | | |
| 662 <value>строка</value></syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
663 <default>off</default> |
| 295 | 664 <context>http</context> |
| 665 <context>server</context> | |
| 666 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
667 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
668 <para> |
| 295 | 669 Разрешает сохранение на диск файлов. |
| 670 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями, | |
| 671 указанными в директивах | |
|
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
672 <link doc="ngx_http_core_module.xml" id="alias"/> или |
|
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
673 <link doc="ngx_http_core_module.xml" id="root"/>. |
| 295 | 674 Параметр <literal>off</literal> запрещает сохранение файлов. |
| 675 Кроме того, имя файла можно задать явно с помощью строки с переменными: | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
676 <example> |
| 295 | 677 fastcgi_store /data/www$original_uri; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
678 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
679 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
680 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
681 <para> |
| 295 | 682 Время изменения файлов выставляется согласно полученному полю |
| 683 <header>Last-Modified</header> в заголовке ответа. | |
| 684 Ответ сначала записывается во временный файл, а потом этот файл | |
| 685 переименовывается. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
686 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
687 могут располагаться на разных файловых системах, но нужно учитывать, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
688 что в этом случае вместо дешёвой операции переименовывания в пределах |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
689 одной файловой системы файл копируется с одной файловой системы на другую. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
690 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
691 системе, что и каталог с временными файлами, задаваемый директивой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
692 <link id="fastcgi_temp_path"/> для данного location. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
693 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
694 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
695 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
696 Директиву можно использовать для создания локальных копий статических |
| 295 | 697 неизменяемых файлов, например, так: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
698 <example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
699 location /images/ { |
| 295 | 700 root /data/www; |
| 701 open_file_cache_errors off; | |
| 702 error_page 404 = /fetch$uri; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
703 } |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
704 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
705 location /fetch/ { |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
706 internal; |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
707 |
| 295 | 708 fastcgi_pass backend:9000; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
709 ... |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
710 |
| 295 | 711 fastcgi_store on; |
| 712 fastcgi_store_access user:rw group:rw all:r; | |
| 713 fastcgi_temp_path /data/temp; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
714 |
| 295 | 715 alias /data/www/; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
716 } |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
717 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
718 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
719 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
720 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
721 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
722 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
723 <directive name="fastcgi_store_access"> |
| 271 | 724 <syntax><value>пользователи</value>:<value>права</value> ...</syntax> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
725 <default>user:rw</default> |
| 295 | 726 <context>http</context> |
| 727 <context>server</context> | |
| 728 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
729 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
730 <para> |
| 295 | 731 Задаёт права доступа для создаваемых файлов и каталогов, например, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
732 <example> |
| 295 | 733 fastcgi_store_access user:rw group:rw all:r; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
735 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
736 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
737 <para> |
| 295 | 738 Если заданы какие-либо права для <literal>group</literal> или |
| 739 <literal>all</literal>, то права для <literal>user</literal> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
740 указывать необязательно: |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
741 <example> |
| 295 | 742 fastcgi_store_access group:rw all:r; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
743 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
744 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
745 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
746 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
747 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
748 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
749 <directive name="fastcgi_temp_path"> |
| 295 | 750 <syntax> |
| 751 <value>путь</value> | |
| 752 [<value>уровень1</value> | |
| 753 [<value>уровень2</value> | |
| 754 [<value>уровень3</value>]]]</syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
755 <default>fastcgi_temp</default> |
| 295 | 756 <context>http</context> |
| 757 <context>server</context> | |
| 758 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
759 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
760 <para> |
| 295 | 761 Задаёт имя каталога для хранения временных файлов, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
762 полученных от другого сервера. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
763 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
764 Например, при такой конфигурации |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
765 <example> |
| 295 | 766 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
767 </example> |
| 295 | 768 временный файл будет следующего вида: |
| 98 | 769 <example> |
| 295 | 770 /spool/nginx/fastcgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
771 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
772 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
773 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
774 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
775 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
776 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
777 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
778 |
| 295 | 779 <section id="parameters" name="Параметры, передаваемые FastCGI-серверу"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
780 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
781 <para> |
| 295 | 782 Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
783 В приложениях и скриптах, запущенных в виде FastCGI-сервера, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
784 эти параметры обычно доступны в виде переменных среды. |
| 295 | 785 Например, поле заголовка <header>User-Agent</header> передаётся как параметр |
| 786 <literal>HTTP_USER_AGENT</literal>. | |
| 787 Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
788 с помощью директивы <link id="fastcgi_param"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
789 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
790 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
791 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
792 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
793 |
| 295 | 794 <section id="variables" name="Встроенные переменные"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
795 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
796 <para> |
| 295 | 797 В модуле <literal>ngx_http_fastcgi_module</literal> есть встроенные переменные, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
798 которые можно использовать для формирования параметров с помощью директивы |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
799 <link id="fastcgi_param"/>: |
| 295 | 800 <list type="tag"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
801 |
| 295 | 802 <tag-name><var>$fastcgi_script_name</var></tag-name> |
| 803 <tag-desc> | |
| 804 URI запроса или же, если URI заканчивается слэшом, | |
| 805 то URI запроса, дополненное именем индексного файла, задаваемого директивой | |
| 806 <link id="fastcgi_index"/>. | |
| 807 Эту переменную можно использовать для задания параметров | |
| 808 <literal>SCRIPT_FILENAME</literal> и <literal>PATH_TRANSLATED</literal>, | |
| 809 используемых, в частности, для определения имени скрипта в PHP. | |
| 810 Например, для запроса “<literal>/info/</literal>” и при использовании | |
| 811 директив | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
812 <example> |
| 295 | 813 fastcgi_index index.php; |
| 814 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
815 </example> |
| 295 | 816 параметр <literal>SCRIPT_FILENAME</literal> будет равен |
| 817 “<literal>/home/www/scripts/php/info/index.php</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
818 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
819 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
820 При использовании директивы <link id="fastcgi_split_path_info"/> |
| 295 | 821 переменная <var>$fastcgi_script_name</var> равна значению первого выделения, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
822 задаваемого этой директивой. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
823 </para> |
| 295 | 824 </tag-desc> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
825 |
| 295 | 826 <tag-name><var>$fastcgi_path_info</var></tag-name> |
| 827 <tag-desc>значение второго выделения, задаваемого директивой | |
| 828 <link id="fastcgi_split_path_info"/>. | |
| 829 Эту переменную можно использовать для задания параметра | |
| 830 <literal>PATH_INFO</literal>. | |
| 831 </tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
832 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
833 </list> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
834 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
835 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
836 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
837 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
838 </module> |