Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 506:657848837328
Documented how nginx processes proxied server's response header fields
(X-Accel-*, Expires, Cache-Control, Set-Cookie) that can be ignored.
| author | Ruslan Ermilov <ru@nginx.com> |
|---|---|
| date | Tue, 24 Apr 2012 07:32:41 +0000 |
| parents | 837bcf62b628 |
| children | d00a4f9b1c5d |
| 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 |
|
411
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
77 <directive name="fastcgi_busy_buffers_size"> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
78 <syntax><value>размер</value></syntax> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
79 <default>8k|16k</default> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
80 <context>http</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
81 <context>server</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
82 <context>location</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
83 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
84 <para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
85 Ограничивает суммарный <value>размер</value> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
86 буферов, которые могут быть заняты для отправки ответа клиенту, пока |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
87 ответ ещё не прочитан целиком. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
88 Оставшиеся буферы тем временем могут использоваться для чтения ответа |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
89 и, при необходимости, буферизации части ответа во временный файл. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
90 По умолчанию <value>размер</value> ограничен двумя буферами, заданными |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
91 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
92 </para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
93 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
94 </directive> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
95 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
96 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
97 <directive name="fastcgi_cache"> |
| 271 | 98 <syntax><value>зона</value> | <literal>off</literal></syntax> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
99 <default>off</default> |
| 295 | 100 <context>http</context> |
| 101 <context>server</context> | |
| 102 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
103 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 <para> |
| 295 | 105 Задаёт зону для кэширования. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
106 Одна и та же зона может использоваться в нескольких местах. |
| 295 | 107 Параметр <literal>off</literal> запрещает кэширование, унаследованное |
| 108 с предыдущего уровня конфигурации. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
109 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
112 |
|
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 <directive name="fastcgi_cache_bypass"> |
| 271 | 115 <syntax><value>строка</value> ...</syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
116 <default/> |
| 295 | 117 <context>http</context> |
| 118 <context>server</context> | |
| 119 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
120 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
121 <para> |
| 295 | 122 Задаёт условия, при которых ответ не будет браться из кэша. |
| 123 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
124 то ответ не берётся из кэша: |
| 98 | 125 <example> |
| 295 | 126 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment; |
| 127 fastcgi_cache_bypass $http_pragma $http_authorization; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
128 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
129 Можно использовать совместно с директивой <link id="fastcgi_no_cache"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
132 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
135 <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
|
136 <syntax><value>строка</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
137 <default/> |
| 295 | 138 <context>http</context> |
| 139 <context>server</context> | |
| 140 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
142 <para> |
| 295 | 143 Задаёт ключ для кэширования, например, |
| 98 | 144 <example> |
| 295 | 145 fastcgi_cache_key localhost:9000$request_uri; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
146 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
147 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
148 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
149 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
150 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
151 |
|
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
152 <directive name="fastcgi_cache_lock"> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
153 <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
|
154 <default>off</default> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
155 <context>http</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
156 <context>server</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
157 <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
|
158 <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
|
159 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
160 <para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
161 Если включено, одновременно только одному запросу будет позволено |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
162 заполнить новый элемент кэша, идентифицируемый согласно директиве |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
163 <link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер. |
|
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 появления ответа в кэше, либо освобождения блокировки |
|
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 <link id="fastcgi_cache_lock_timeout"/>. |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
168 </para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
169 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
170 </directive> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
171 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
172 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
173 <directive name="fastcgi_cache_lock_timeout"> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
174 <syntax><value>время</value></syntax> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
175 <default>5s</default> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
176 <context>http</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
177 <context>server</context> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
178 <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
|
179 <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
|
180 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
181 <para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
182 Задаёт таймаут для <link id="fastcgi_cache_lock"/>. |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
183 </para> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
184 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
185 </directive> |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
186 |
|
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
299
diff
changeset
|
187 |
| 295 | 188 <directive name="fastcgi_cache_min_uses"> |
| 189 <syntax><value>число</value></syntax> | |
| 190 <default>1</default> | |
| 191 <context>http</context> | |
| 192 <context>server</context> | |
| 193 <context>location</context> | |
| 194 | |
| 195 <para> | |
| 196 Задаёт <value>число</value> запросов, после которого ответ будет закэширован. | |
| 197 </para> | |
| 198 | |
| 199 </directive> | |
| 200 | |
| 201 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
202 <directive name="fastcgi_cache_path"> |
| 271 | 203 <syntax> |
| 364 | 204 <value>путь</value> |
| 205 [<literal>levels</literal>=<value>уровни</value>] | |
| 206 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> | |
| 207 [<literal>inactive</literal>=<value>время</value>] | |
| 208 [<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
|
209 <default/> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
210 <context>http</context> |
|
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 <para> |
| 295 | 213 Задаёт путь и другие параметры кэша. |
| 214 Данные кэша хранятся в файлах. | |
| 215 Ключом и именем файла в кэше является результат функции MD5 | |
| 216 от проксированного URL. | |
| 217 Параметр <literal>levels</literal> задаёт уровни иерархии кэша, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
218 например, при использовании |
| 98 | 219 <example> |
| 295 | 220 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
|
221 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
222 имена файлов в кэше будут такого вида: |
| 98 | 223 <example> |
| 295 | 224 /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
|
225 </example> |
|
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 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл |
| 364 | 230 переименовывается. |
| 231 Начиная с версии 0.8.9, временные файлы и кэш | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
232 могут располагаться на разных файловых системах, но нужно учитывать, |
|
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 одной файловой системы файл копируется с одной файловой системы на другую. |
|
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 <link id="fastcgi_temp_path"/> для данного location. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
238 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
239 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
240 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
241 Кроме того, все активные ключи и информация о данных хранятся в разделяемой |
| 295 | 242 памяти — зоне, <value>имя</value> и <value>размер</value> которой |
| 243 задаются параметром <literal>keys_zone</literal>. | |
| 285 | 244 Если к данным кэша не обращаются в течение времени, заданного параметром |
| 295 | 245 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. |
| 246 По умолчанию <literal>inactive</literal> равен 10 минутам. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
247 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
248 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
249 <para> |
| 295 | 250 Специальный процесс “cache manager” следит за максимальным размером кэша, |
| 251 заданным параметром <literal>max_size</literal>, и при превышении | |
| 252 его размеров удаляет самые невостребованные данные. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
253 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
254 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
255 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
256 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
257 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
258 <directive name="fastcgi_cache_use_stale"> |
| 271 | 259 <syntax> |
| 364 | 260 <literal>error</literal> | |
| 261 <literal>timeout</literal> | | |
| 262 <literal>invalid_header</literal> | | |
| 263 <literal>updating</literal> | | |
| 264 <literal>http_500</literal> | | |
| 265 <literal>http_503</literal> | | |
| 266 <literal>http_404</literal> | | |
| 267 <literal>off</literal> | |
| 268 ...</syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
269 <default>off</default> |
| 295 | 270 <context>http</context> |
| 271 <context>server</context> | |
| 272 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
273 |
| 295 | 274 <para> |
| 275 Определяет, в каких случаях можно использовать устаревший закэшированный ответ, | |
| 276 если при работе с FastCGI-сервером возникла ошибка. | |
| 277 Параметры директивы совпадают с параметрами | |
| 278 директивы <link id="fastcgi_next_upstream"/>. | |
|
505
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
279 </para> |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
280 |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
281 <para> |
| 295 | 282 Кроме того, дополнительный параметр <literal>updating</literal> |
| 283 разрешает использовать устаревший закэшированный ответ, | |
| 284 если на данный момент он уже обновляется. | |
|
505
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
285 Это позволяет минимизировать число обращений к FastCGI-серверам |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
286 при обновлении закэшированных данных. |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
287 </para> |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
288 |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
289 <para> |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
290 Чтобы минимизировать число обращений к FastCGI-серверам при |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
291 заполнении нового элемента кэша, можно воспользоваться директивой |
|
837bcf62b628
Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
498
diff
changeset
|
292 <link id="fastcgi_cache_lock"/>. |
| 295 | 293 </para> |
| 294 | |
| 295 </directive> | |
| 296 | |
| 297 | |
| 298 <directive name="fastcgi_cache_valid"> | |
| 299 <syntax>[<value>код</value> ...] <value>время</value></syntax> | |
| 300 <default/> | |
| 301 <context>http</context> | |
| 302 <context>server</context> | |
| 303 <context>location</context> | |
|
76
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 <para> |
| 295 | 306 Задаёт время кэширования для разных кодов ответа. |
| 307 Например, директивы | |
| 308 <example> | |
| 309 fastcgi_cache_valid 200 302 10m; | |
| 310 fastcgi_cache_valid 404 1m; | |
| 311 </example> | |
| 312 задают время кэширования 10 минут для ответов с кодами 200 и 302, | |
| 313 и 1 минуту для ответов с кодом 404. | |
| 314 </para> | |
| 315 | |
| 316 <para> | |
| 317 Если указано только <value>время</value> кэширования, | |
| 318 <example> | |
| 319 fastcgi_cache_valid 5m; | |
| 320 </example> | |
| 321 то кэшируются только ответы 200, 301 и 302. | |
| 322 </para> | |
| 323 | |
| 324 <para> | |
| 325 Кроме того, можно кэшировать любые ответы с помощью параметра | |
| 326 <literal>any</literal>: | |
| 327 <example> | |
| 328 fastcgi_cache_valid 200 302 10m; | |
| 329 fastcgi_cache_valid 301 1h; | |
| 330 fastcgi_cache_valid any 1m; | |
| 331 </example> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
332 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
333 |
|
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
334 <para> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
335 Параметры кэширования могут также быть заданы непосредственно |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
336 в заголовке ответа. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
337 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
338 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
339 ответа в секундах. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
340 Значение 0 запрещает кэшировать ответ. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
341 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
342 время в секундах с начала эпохи, до которого ответ может быть закэширован. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
343 Если в заголовке нет поля <header>X-Accel-Expires</header>, |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
344 параметры кэширования определяются по полям заголовка |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
345 <header>Expires</header> или <header>Cache-Control</header>. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
346 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>, |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
347 не будет кэшироваться. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
348 Обработка одного или более из этих полей заголовка может быть отключена |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
349 при помощи директивы <link id="fastcgi_ignore_headers"/>. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
350 </para> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
351 |
|
76
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_connect_timeout"> |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
356 <syntax><value>время</value></syntax> |
| 295 | 357 <default>60s</default> |
| 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 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
365 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
366 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
367 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
368 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
369 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
370 <directive name="fastcgi_hide_header"> |
| 295 | 371 <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
|
372 <default/> |
| 295 | 373 <context>http</context> |
| 374 <context>server</context> | |
| 375 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
376 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
377 <para> |
| 295 | 378 По умолчанию |
| 379 nginx не передаёт клиенту поля заголовка <header>Status</header> и | |
| 380 <header>X-Accel-...</header> из ответа FastCGI-сервера. | |
| 381 Директива <literal>fastcgi_hide_header</literal> задаёт дополнительные поля, | |
| 382 которые не будут передаваться. | |
| 383 Если же передачу полей нужно разрешить, можно воспользоваться | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
384 директивой <link id="fastcgi_pass_header"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
385 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
386 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
387 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
388 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
389 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
390 <directive name="fastcgi_ignore_client_abort"> |
| 271 | 391 <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
|
392 <default>off</default> |
| 295 | 393 <context>http</context> |
| 394 <context>server</context> | |
| 395 <context>location</context> | |
|
76
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 <para> |
| 295 | 398 Определяет, закрывать ли соединение с FastCGI-сервером |
|
76
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 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
401 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
402 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
403 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
404 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
405 <directive name="fastcgi_ignore_headers"> |
| 295 | 406 <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
|
407 <default/> |
| 295 | 408 <context>http</context> |
| 409 <context>server</context> | |
| 410 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
411 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
412 <para> |
| 295 | 413 Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера. |
| 414 В директиве можно указать поля <header>X-Accel-Redirect</header>, | |
| 415 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), | |
| 416 <header>X-Accel-Buffering</header> (1.1.6), | |
| 417 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, | |
| 418 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44). | |
| 419 </para> | |
| 420 | |
|
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
421 <para> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
422 Если не запрещено, обработка этих полей заголовка заключается в следующем: |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
423 <list type="bullet" compact="no"> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
424 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
425 <listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
426 <header>X-Accel-Expires</header>, <header>Expires</header>, |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
427 <header>Cache-Control</header> и <header>Set-Cookie</header> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
428 задают параметры <link id="fastcgi_cache_valid">кэширования</link> ответа; |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
429 </listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
430 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
431 <listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
432 <header>X-Accel-Redirect</header> производит |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
433 <link doc="ngx_http_core_module.xml" id="internal">внутреннее |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
434 перенаправление</link> на указанный URI; |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
435 </listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
436 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
437 <listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
438 <header>X-Accel-Limit-Rate</header> задаёт |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
439 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
440 скорости</link> передачи ответа клиенту; |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
441 </listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
442 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
443 <listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
444 <header>X-Accel-Buffering</header> включает или выключает |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
445 буферизацию ответа; |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
446 </listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
447 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
448 <listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
449 <header>X-Accel-Charset</header> задаёт желаемую |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
450 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
451 ответа. |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
452 </listitem> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
453 |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
454 </list> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
455 </para> |
|
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
505
diff
changeset
|
456 |
| 295 | 457 </directive> |
| 458 | |
| 459 | |
| 460 <directive name="fastcgi_index"> | |
| 461 <syntax><value>имя</value></syntax> | |
| 462 <default/> | |
| 463 <context>http</context> | |
| 464 <context>server</context> | |
| 465 <context>location</context> | |
| 466 | |
| 467 <para> | |
| 468 Задаёт имя файла, который при создании переменной | |
| 469 <var>$fastcgi_script_name</var> будет добавляться после URI, | |
| 470 если URI заканчивается слэшом. | |
| 471 Например, при таких настройках | |
| 472 <example> | |
| 473 fastcgi_index index.php; | |
| 474 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; | |
| 475 </example> | |
| 476 и запросе “<literal>/page.php</literal>” | |
| 477 параметр <literal>SCRIPT_FILENAME</literal> будет равен | |
| 478 “<literal>/home/www/scripts/php/page.php</literal>”, | |
| 479 а при запросе “<literal>/</literal>”— | |
| 480 “<literal>/home/www/scripts/php/index.php</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
481 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
482 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
483 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
484 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
485 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
486 <directive name="fastcgi_intercept_errors"> |
| 271 | 487 <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
|
488 <default>off</default> |
| 295 | 489 <context>http</context> |
| 490 <context>server</context> | |
| 491 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
492 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
493 <para> |
| 295 | 494 Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом |
| 495 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью | |
| 496 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>. | |
| 98 | 497 </para> |
| 498 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
499 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
500 |
| 364 | 501 |
|
316
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
502 <directive name="fastcgi_keep_conn"> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
503 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
504 <default>off</default> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
505 <context>http</context> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
506 <context>server</context> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
507 <context>location</context> |
|
498
65843513cff5
Documented that "fastcgi_keep_conn" appeared in 1.1.4.
Ruslan Ermilov <ru@nginx.com>
parents:
411
diff
changeset
|
508 <appeared-in>1.1.4</appeared-in> |
|
316
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
509 |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
510 <para> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
511 По умолчанию FastCGI-сервер будет закрывать соединение сразу же |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
512 после отправки ответа. |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
513 При установке значения <literal>on</literal> nginx указывает |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
514 FastCGI-серверу оставлять соединения открытыми. |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
515 Это в частности требуется для функционирования |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
516 <link doc="ngx_http_upstream_module.xml" id="keepalive">постоянных |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
517 соединений</link> с FastCGI-серверами. |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
518 </para> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
519 |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
520 </directive> |
|
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
521 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
522 |
|
411
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
523 <directive name="fastcgi_max_temp_file_size"> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
524 <syntax><value>размер</value></syntax> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
525 <default>1024m</default> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
526 <context>http</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
527 <context>server</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
528 <context>location</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
529 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
530 <para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
531 Если ответ не вмещается целиком в буферы памяти, заданные |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
532 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>, |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
533 часть ответа может быть записана во временный файл. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
534 Эта директива задаёт максимальный <value>размер</value> временного файла. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
535 Размер данных, сбрасываемых во временный файл за один раз, задаётся |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
536 директивой <link id="fastcgi_temp_file_write_size"/>. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
537 </para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
538 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
539 <para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
540 Значение 0 отключает возможность буферизации ответов во временные файлы. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
541 </para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
542 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
543 </directive> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
544 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
545 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
546 <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
|
547 <syntax> |
| 364 | 548 <literal>error</literal> | |
| 549 <literal>timeout</literal> | | |
| 550 <literal>invalid_header</literal> | | |
| 551 <literal>http_500</literal> | | |
| 552 <literal>http_503</literal> | | |
| 553 <literal>http_404</literal> | | |
| 554 <literal>off</literal> | |
| 555 ...</syntax> | |
|
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
556 <default>error timeout</default> |
| 295 | 557 <context>http</context> |
| 558 <context>server</context> | |
| 559 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
560 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
561 <para> |
| 295 | 562 Определяет, в каких случаях запрос будет передан следующему серверу: |
| 563 <list type="tag"> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
564 |
| 295 | 565 <tag-name><literal>error</literal></tag-name> |
| 566 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или | |
| 567 чтения заголовка ответа сервера;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
568 |
| 295 | 569 <tag-name><literal>timeout</literal></tag-name> |
| 570 <tag-desc>произошёл таймаут во время соединения с сервером, | |
| 571 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
572 |
| 295 | 573 <tag-name><literal>invalid_header</literal></tag-name> |
| 574 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
575 |
| 295 | 576 <tag-name><literal>http_500</literal></tag-name> |
| 577 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
578 |
| 295 | 579 <tag-name><literal>http_503</literal></tag-name> |
| 580 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
581 |
| 295 | 582 <tag-name><literal>http_404</literal></tag-name> |
| 583 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
584 |
| 295 | 585 <tag-name><literal>off</literal></tag-name> |
| 586 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
587 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
588 </list> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
589 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
590 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
591 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
592 Необходимо понимать, что передача запроса следующему серверу возможна |
|
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 то исправить это уже невозможно. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
596 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
597 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
598 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
599 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
600 |
| 295 | 601 <directive name="fastcgi_no_cache"> |
| 602 <syntax><value>строка</value> ...</syntax> | |
| 603 <default/> | |
| 604 <context>http</context> | |
| 605 <context>server</context> | |
| 606 <context>location</context> | |
| 607 | |
| 608 <para> | |
| 609 Задаёт условия, при которых ответ не будет сохраняться в кэш. | |
| 610 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, | |
| 611 то ответ не будет сохранён: | |
| 612 <example> | |
| 613 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment; | |
| 614 fastcgi_no_cache $http_pragma $http_authorization; | |
| 615 </example> | |
| 616 Можно использовать совместно с директивой <link id="fastcgi_cache_bypass"/>. | |
| 617 </para> | |
| 618 | |
| 619 </directive> | |
| 620 | |
| 621 | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
622 <directive name="fastcgi_param"> |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
623 <syntax> |
| 271 | 624 <value>параметр</value> <value>значение</value> |
| 625 [<literal>if_not_empty</literal>]</syntax> | |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
626 <default/> |
| 295 | 627 <context>http</context> |
| 628 <context>server</context> | |
| 629 <context>location</context> | |
|
76
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 <para> |
| 295 | 632 Задаёт <value>параметр</value>, который будет передаваться FastCGI-серверу. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
633 В качестве значения можно использовать текст, переменные и их комбинации. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
634 Директивы наследуются с предыдущего уровня при условии, что на данном |
| 271 | 635 уровне не описаны свои директивы <literal>fastcgi_param</literal>. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
636 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
637 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
638 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
639 Ниже приведён пример минимально необходимых параметров для PHP: |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
640 <example> |
| 295 | 641 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; |
| 642 fastcgi_param QUERY_STRING $query_string; | |
|
76
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 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
645 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
646 <para> |
| 295 | 647 Параметр <literal>SCRIPT_FILENAME</literal> используется в PHP для |
| 648 определения имени скрипта, а в параметре <literal>QUERY_STRING</literal> | |
| 649 передаются параметры запроса. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
650 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
651 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
652 <para> |
| 295 | 653 Если скрипты обрабатывают запросы <literal>POST</literal>, то нужны |
| 654 ещё три параметра: | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
655 <example> |
| 295 | 656 fastcgi_param REQUEST_METHOD $request_method; |
| 657 fastcgi_param CONTENT_TYPE $content_type; | |
| 658 fastcgi_param CONTENT_LENGTH $content_length; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
659 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
660 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
661 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
662 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
663 Если PHP был собран с параметром конфигурации |
| 271 | 664 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать |
| 295 | 665 параметр <literal>REDIRECT_STATUS</literal> со значением “200”: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
666 <example> |
| 295 | 667 fastcgi_param REDIRECT_STATUS 200; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
668 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
669 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
670 |
|
239
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
671 <para> |
| 295 | 672 Если директива указана с <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
|
673 то такой параметр с пустым значением передаваться на сервер не будет: |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
674 <example> |
| 295 | 675 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
|
676 </example> |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
677 </para> |
|
fe72da550150
"fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
678 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
679 </directive> |
|
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 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
682 <directive name="fastcgi_pass"> |
| 295 | 683 <syntax><value>адрес</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
684 <default/> |
| 295 | 685 <context>location</context> |
| 686 <context>if в location</context> | |
|
76
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 <para> |
| 295 | 689 Задаёт адрес FastCGI-сервера. |
| 690 Адрес может быть указан в виде доменного имени или адреса, и порта, например, | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
691 <example> |
|
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
692 fastcgi_pass localhost:9000; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
693 </example> |
| 295 | 694 или в виде пути UNIX-сокета: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
695 <example> |
|
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
696 fastcgi_pass unix:/tmp/fastcgi.socket; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
697 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
698 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
699 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
700 <para> |
| 295 | 701 Если доменному имени соответствует несколько адресов, то все они будут |
| 702 использоваться по очереди (round-robin). | |
| 703 И, кроме того, адрес может быть | |
|
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
704 <link doc="ngx_http_upstream_module.xml">группой серверов</link>. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
705 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
706 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
707 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
708 |
|
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 <directive name="fastcgi_pass_header"> |
| 295 | 711 <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
|
712 <default/> |
| 295 | 713 <context>http</context> |
| 714 <context>server</context> | |
| 715 <context>location</context> | |
|
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 <para> |
| 295 | 718 Разрешает передавать от FastCGI-сервера клиенту |
| 719 <link id="fastcgi_hide_header">запрещённые для передачи</link> поля заголовка. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
720 </para> |
|
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 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
723 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
724 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
725 <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
|
726 <syntax><value>время</value></syntax> |
| 295 | 727 <default>60s</default> |
| 728 <context>http</context> | |
| 729 <context>server</context> | |
| 730 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
731 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
732 <para> |
| 295 | 733 Задаёт таймаут при чтении ответа FastCGI-сервера. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 Таймаут устанавливается не на всю передачу ответа, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
735 а только между двумя операциями чтения. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
736 Если по истечении этого времени FastCGI-сервер ничего не передаст, |
| 295 | 737 соединение закрывается. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
738 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
739 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
740 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
741 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
742 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
743 <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
|
744 <syntax><value>время</value></syntax> |
| 295 | 745 <default>60s</default> |
| 746 <context>http</context> | |
| 747 <context>server</context> | |
| 748 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
749 |
| 98 | 750 <para> |
| 295 | 751 Задаёт таймаут при передаче запроса FastCGI-серверу. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
752 Таймаут устанавливается не на всю передачу запроса, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
753 а только между двумя операциями записи. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
754 Если по истечении этого времени FastCGI-сервер не примет новых данных, |
| 295 | 755 соединение закрывается. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
756 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
757 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
758 </directive> |
|
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 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
761 <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
|
762 <syntax><value>regex</value></syntax> |
|
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
763 <default/> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
764 <context>location</context> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
765 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
766 <para> |
| 295 | 767 Задаёт регулярное выражение, выделяющее значение для переменной |
| 768 <var>$fastcgi_path_info</var>. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
769 Регулярное выражение должно иметь два выделения, из которых первое |
| 295 | 770 становится значением переменной <var>$fastcgi_script_name</var>, |
| 771 а второе—значением переменной <var>$fastcgi_path_info</var>. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
772 Например, при таких настройках |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
773 <example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
774 location ~ ^(.+\.php)(.*)$ { |
| 295 | 775 fastcgi_split_path_info ^(.+\.php)(.*)$; |
| 776 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name; | |
| 777 fastcgi_param PATH_INFO $fastcgi_path_info; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
778 </example> |
| 295 | 779 и запросе “<literal>/show.php/article/0001</literal>” |
| 780 параметр <literal>SCRIPT_FILENAME</literal> будет равен | |
| 781 “<literal>/path/to/php/show.php</literal>”, а параметр | |
| 782 <literal>PATH_INFO</literal>—“<literal>/article/0001</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
783 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
784 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
785 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
786 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
787 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
788 <directive name="fastcgi_store"> |
| 271 | 789 <syntax> |
| 295 | 790 <literal>on</literal> | |
| 791 <literal>off</literal> | | |
| 792 <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
|
793 <default>off</default> |
| 295 | 794 <context>http</context> |
| 795 <context>server</context> | |
| 796 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
797 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
798 <para> |
| 295 | 799 Разрешает сохранение на диск файлов. |
| 800 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями, | |
| 801 указанными в директивах | |
|
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
802 <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
|
803 <link doc="ngx_http_core_module.xml" id="root"/>. |
| 295 | 804 Параметр <literal>off</literal> запрещает сохранение файлов. |
| 805 Кроме того, имя файла можно задать явно с помощью строки с переменными: | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
806 <example> |
| 295 | 807 fastcgi_store /data/www$original_uri; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
808 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
809 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
810 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
811 <para> |
| 295 | 812 Время изменения файлов выставляется согласно полученному полю |
| 813 <header>Last-Modified</header> в заголовке ответа. | |
| 814 Ответ сначала записывается во временный файл, а потом этот файл | |
| 815 переименовывается. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
816 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
817 могут располагаться на разных файловых системах, но нужно учитывать, |
|
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 одной файловой системы файл копируется с одной файловой системы на другую. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
820 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
821 системе, что и каталог с временными файлами, задаваемый директивой |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
822 <link id="fastcgi_temp_path"/> для данного location. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
823 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
824 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
825 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
826 Директиву можно использовать для создания локальных копий статических |
| 295 | 827 неизменяемых файлов, например, так: |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
828 <example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
829 location /images/ { |
| 295 | 830 root /data/www; |
| 831 open_file_cache_errors off; | |
| 832 error_page 404 = /fetch$uri; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
833 } |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
834 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
835 location /fetch/ { |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
836 internal; |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
837 |
| 295 | 838 fastcgi_pass backend:9000; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
839 ... |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
840 |
| 295 | 841 fastcgi_store on; |
| 842 fastcgi_store_access user:rw group:rw all:r; | |
| 843 fastcgi_temp_path /data/temp; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
844 |
| 295 | 845 alias /data/www/; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
846 } |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
847 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
848 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
849 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
850 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
851 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
852 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
853 <directive name="fastcgi_store_access"> |
| 271 | 854 <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
|
855 <default>user:rw</default> |
| 295 | 856 <context>http</context> |
| 857 <context>server</context> | |
| 858 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
859 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
860 <para> |
| 295 | 861 Задаёт права доступа для создаваемых файлов и каталогов, например, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
862 <example> |
| 295 | 863 fastcgi_store_access user:rw group:rw all:r; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
864 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
865 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
866 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
867 <para> |
| 295 | 868 Если заданы какие-либо права для <literal>group</literal> или |
| 869 <literal>all</literal>, то права для <literal>user</literal> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
870 указывать необязательно: |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
871 <example> |
| 295 | 872 fastcgi_store_access group:rw all:r; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
873 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
874 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
875 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
876 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
877 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
878 |
|
411
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
879 <directive name="fastcgi_temp_file_write_size"> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
880 <syntax><value>размер</value></syntax> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
881 <default>8k|16k</default> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
882 <context>http</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
883 <context>server</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
884 <context>location</context> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
885 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
886 <para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
887 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
888 за один раз, при включённой буферизации ответов FastCGI-сервера |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
889 во временные файлы. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
890 По умолчанию <value>размер</value> ограничен двумя буферами, заданными |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
891 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
892 Максимальный размер временного файла задаётся директивой |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
893 <link id="fastcgi_max_temp_file_size"/>. |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
894 </para> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
895 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
896 </directive> |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
897 |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
898 |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
899 <directive name="fastcgi_temp_path"> |
| 295 | 900 <syntax> |
| 901 <value>путь</value> | |
| 902 [<value>уровень1</value> | |
| 903 [<value>уровень2</value> | |
| 904 [<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
|
905 <default>fastcgi_temp</default> |
| 295 | 906 <context>http</context> |
| 907 <context>server</context> | |
| 908 <context>location</context> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
909 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
910 <para> |
|
411
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
911 Задаёт имя каталога для хранения временных файлов с данными, |
|
f8248d0e3c8f
Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
367
diff
changeset
|
912 полученными от FastCGI-серверов. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
913 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
914 Например, при такой конфигурации |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
915 <example> |
| 295 | 916 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2; |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
917 </example> |
| 295 | 918 временный файл будет следующего вида: |
| 98 | 919 <example> |
| 295 | 920 /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
|
921 </example> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
922 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
923 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
924 </directive> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
925 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
926 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
927 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
928 |
| 295 | 929 <section id="parameters" name="Параметры, передаваемые FastCGI-серверу"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
930 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
931 <para> |
| 295 | 932 Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров. |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
933 В приложениях и скриптах, запущенных в виде FastCGI-сервера, |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
934 эти параметры обычно доступны в виде переменных среды. |
| 295 | 935 Например, поле заголовка <header>User-Agent</header> передаётся как параметр |
| 936 <literal>HTTP_USER_AGENT</literal>. | |
| 937 Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
938 с помощью директивы <link id="fastcgi_param"/>. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
939 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
940 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
941 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
942 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
943 |
| 295 | 944 <section id="variables" name="Встроенные переменные"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
945 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
946 <para> |
| 295 | 947 В модуле <literal>ngx_http_fastcgi_module</literal> есть встроенные переменные, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
948 которые можно использовать для формирования параметров с помощью директивы |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
949 <link id="fastcgi_param"/>: |
| 295 | 950 <list type="tag"> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
951 |
| 295 | 952 <tag-name><var>$fastcgi_script_name</var></tag-name> |
| 953 <tag-desc> | |
| 954 URI запроса или же, если URI заканчивается слэшом, | |
|
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
955 то URI запроса, дополненное именем индексного файла, задаваемого директивой |
| 295 | 956 <link id="fastcgi_index"/>. |
| 957 Эту переменную можно использовать для задания параметров | |
| 958 <literal>SCRIPT_FILENAME</literal> и <literal>PATH_TRANSLATED</literal>, | |
| 959 используемых, в частности, для определения имени скрипта в PHP. | |
| 960 Например, для запроса “<literal>/info/</literal>” и при использовании | |
| 961 директив | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
962 <example> |
| 295 | 963 fastcgi_index index.php; |
| 964 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
965 </example> |
| 295 | 966 параметр <literal>SCRIPT_FILENAME</literal> будет равен |
| 967 “<literal>/home/www/scripts/php/info/index.php</literal>”. | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
968 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
969 <para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
970 При использовании директивы <link id="fastcgi_split_path_info"/> |
| 295 | 971 переменная <var>$fastcgi_script_name</var> равна значению первого выделения, |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
972 задаваемого этой директивой. |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
973 </para> |
| 295 | 974 </tag-desc> |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
975 |
| 295 | 976 <tag-name><var>$fastcgi_path_info</var></tag-name> |
| 977 <tag-desc>значение второго выделения, задаваемого директивой | |
| 978 <link id="fastcgi_split_path_info"/>. | |
| 979 Эту переменную можно использовать для задания параметра | |
| 980 <literal>PATH_INFO</literal>. | |
| 981 </tag-desc> | |
|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
982 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
983 </list> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
984 </para> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
985 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
986 </section> |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
987 |
|
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
988 </module> |