comparison xml/en/docs/http/ngx_http_fastcgi_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 8e7995bb8c6b
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_fastcgi_module" 10 <module name="Module ngx_http_fastcgi_module"
11 link="/en/docs/http/ngx_http_fastcgi_module.html" 11 link="/en/docs/http/ngx_http_fastcgi_module.html"
12 lang="en" 12 lang="en"
13 rev="26"> 13 rev="27">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_fastcgi_module</literal> module allows passing 18 The <literal>ngx_http_fastcgi_module</literal> module allows passing
321 321
322 <directive name="fastcgi_cache_path"> 322 <directive name="fastcgi_cache_path">
323 <syntax> 323 <syntax>
324 <value>path</value> 324 <value>path</value>
325 [<literal>levels</literal>=<value>levels</value>] 325 [<literal>levels</literal>=<value>levels</value>]
326 [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
326 <literal>keys_zone</literal>=<value>name</value>:<value>size</value> 327 <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
327 [<literal>inactive</literal>=<value>time</value>] 328 [<literal>inactive</literal>=<value>time</value>]
328 [<literal>max_size</literal>=<value>size</value>] 329 [<literal>max_size</literal>=<value>size</value>]
329 [<literal>loader_files</literal>=<value>number</value>] 330 [<literal>loader_files</literal>=<value>number</value>]
330 [<literal>loader_sleep</literal>=<value>time</value>] 331 [<literal>loader_sleep</literal>=<value>time</value>]
355 Starting from version 0.8.9, temporary files and the cache can be put on 356 Starting from version 0.8.9, temporary files and the cache can be put on
356 different file systems. 357 different file systems.
357 However, be aware that in this case a file is copied 358 However, be aware that in this case a file is copied
358 across two file systems instead of the cheap renaming operation. 359 across two file systems instead of the cheap renaming operation.
359 It is thus recommended that for any given location both cache and a directory 360 It is thus recommended that for any given location both cache and a directory
360 holding temporary files, set by the <link id="fastcgi_temp_path"/> directive, 361 holding temporary files
361 are put on the same file system. 362 are put on the same file system.
363 A directory for temporary files is set based on
364 the <literal>use_temp_path</literal> parameter (1.7.10).
365 If this parameter is omitted or set to the value <literal>on</literal>,
366 the directory set by the <link id="fastcgi_temp_path"/> directive
367 for the given location will be used.
368 If the value is set to <literal>off</literal>,
369 temporary files will be put directly in the cache directory.
362 </para> 370 </para>
363 371
364 <para> 372 <para>
365 In addition, all active keys and information about data are stored 373 In addition, all active keys and information about data are stored
366 in a shared memory zone, whose <value>name</value> and <value>size</value> 374 in a shared memory zone, whose <value>name</value> and <value>size</value>
1348 <example> 1356 <example>
1349 /spool/nginx/fastcgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> 1357 /spool/nginx/fastcgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
1350 </example> 1358 </example>
1351 </para> 1359 </para>
1352 1360
1361 <para>
1362 See also the <literal>use_temp_path</literal> parameter of the
1363 <link id="fastcgi_cache_path"/> directive.
1364 </para>
1365
1353 </directive> 1366 </directive>
1354 1367
1355 </section> 1368 </section>
1356 1369
1357 1370