Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1028:e582a10b1917

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives.
author Vladimir Homutov <vl@nginx.com>
date Mon, 02 Dec 2013 15:24:51 +0400
parents af77dd40abeb
children 379cb572a7ec
comparison
equal deleted inserted replaced
1027:dd64ce140de2 1028:e582a10b1917
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="12"> 13 rev="13">
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
361 are loaded (by default, 100). 361 are loaded (by default, 100).
362 Besides, the duration of one iteration is limited by the 362 Besides, the duration of one iteration is limited by the
363 <literal>loader_threshold</literal> parameter (by default, 200 milliseconds). 363 <literal>loader_threshold</literal> parameter (by default, 200 milliseconds).
364 Between iterations, a pause configured by the <literal>loader_sleep</literal> 364 Between iterations, a pause configured by the <literal>loader_sleep</literal>
365 parameter (by default, 50 milliseconds) is made. 365 parameter (by default, 50 milliseconds) is made.
366 </para>
367
368 </directive>
369
370
371 <directive name="fastcgi_cache_purge">
372 <syntax>string ...</syntax>
373 <default/>
374 <context>http</context>
375 <context>server</context>
376 <context>location</context>
377 <appeared-in>1.5.7</appeared-in>
378
379 <para>
380 Defines conditions under which the request will be considered a cache
381 purge request.
382 If at least one value of the string parameters is not empty and is not equal
383 to “0” then the cache entry with a corresponding
384 <link id="fastcgi_cache_key">cache key</link> is removed.
385 The result of successful operation is indicated by returning
386 the <http-status code="204" text="No Content"/> response.
387 </para>
388
389 <para>
390 If the <link id="fastcgi_cache_key">cache key</link> of a purge request ends
391 with an asterisk (“<literal>*</literal>”), all cache entries matching the
392 wildcard key will be removed from the cache.
393 </para>
394
395 <para>
396 Example configuration:
397 <example>
398 fastcgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
399
400 map $request_method $purge_method {
401 PURGE 1;
402 default 0;
403 }
404
405 server {
406 ...
407 location / {
408 fastcgi_pass backend;
409 fastcgi_cache cache_zone;
410 fastcgi_cache_key $uri;
411 fastcgi_cache_purge $purge_method;
412 }
413 }
414 </example>
415 <note>
416 This functionality is available as part of our <commercial_version/> only.
417 </note>
366 </para> 418 </para>
367 419
368 </directive> 420 </directive>
369 421
370 422