Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 1384:66ee77849563

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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