Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 1384:66ee77849563
Documented the use_temp_path parameter of the proxy_cache_path directive.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 24 Dec 2014 19:31:21 +0300 |
parents | 94cac978bda3 |
children | 5addfab7e171 |
comparison
equal
deleted
inserted
replaced
1383:0f63ac5c9463 | 1384:66ee77849563 |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Module ngx_http_proxy_module" | 10 <module name="Module ngx_http_proxy_module" |
11 link="/en/docs/http/ngx_http_proxy_module.html" | 11 link="/en/docs/http/ngx_http_proxy_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="34"> | 13 rev="35"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_proxy_module</literal> module allows passing | 18 The <literal>ngx_http_proxy_module</literal> module allows passing |
319 | 319 |
320 <directive name="proxy_cache_path"> | 320 <directive name="proxy_cache_path"> |
321 <syntax> | 321 <syntax> |
322 <value>path</value> | 322 <value>path</value> |
323 [<literal>levels</literal>=<value>levels</value>] | 323 [<literal>levels</literal>=<value>levels</value>] |
324 [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>] | |
324 <literal>keys_zone</literal>=<value>name</value>:<value>size</value> | 325 <literal>keys_zone</literal>=<value>name</value>:<value>size</value> |
325 [<literal>inactive</literal>=<value>time</value>] | 326 [<literal>inactive</literal>=<value>time</value>] |
326 [<literal>max_size</literal>=<value>size</value>] | 327 [<literal>max_size</literal>=<value>size</value>] |
327 [<literal>loader_files</literal>=<value>number</value>] | 328 [<literal>loader_files</literal>=<value>number</value>] |
328 [<literal>loader_sleep</literal>=<value>time</value>] | 329 [<literal>loader_sleep</literal>=<value>time</value>] |
353 Starting from version 0.8.9, temporary files and the cache can be put on | 354 Starting from version 0.8.9, temporary files and the cache can be put on |
354 different file systems. | 355 different file systems. |
355 However, be aware that in this case a file is copied | 356 However, be aware that in this case a file is copied |
356 across two file systems instead of the cheap renaming operation. | 357 across two file systems instead of the cheap renaming operation. |
357 It is thus recommended that for any given location both cache and a directory | 358 It is thus recommended that for any given location both cache and a directory |
358 holding temporary files, set by the <link id="proxy_temp_path"/> directive, | 359 holding temporary files |
359 are put on the same file system. | 360 are put on the same file system. |
361 A directory for temporary files is set based on | |
362 the <literal>use_temp_path</literal> parameter (1.7.10). | |
363 If this parameter is omitted or set to the value <literal>on</literal>, | |
364 the directory set by the <link id="proxy_temp_path"/> directive | |
365 for the given location will be used. | |
366 If the value is set to <literal>off</literal>, | |
367 temporary files will be put directly in the cache directory. | |
360 </para> | 368 </para> |
361 | 369 |
362 <para> | 370 <para> |
363 In addition, all active keys and information about data are stored | 371 In addition, all active keys and information about data are stored |
364 in a shared memory zone, whose <value>name</value> and <value>size</value> | 372 in a shared memory zone, whose <value>name</value> and <value>size</value> |
1939 <example> | 1947 <example> |
1940 /spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> | 1948 /spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> |
1941 </example> | 1949 </example> |
1942 </para> | 1950 </para> |
1943 | 1951 |
1952 <para> | |
1953 See also the <literal>use_temp_path</literal> parameter of the | |
1954 <link id="proxy_cache_path"/> directive. | |
1955 </para> | |
1956 | |
1944 </directive> | 1957 </directive> |
1945 | 1958 |
1946 </section> | 1959 </section> |
1947 | 1960 |
1948 | 1961 |