# HG changeset patch
# User Homutov Vladimir <vl@nginx.com>
# Date 1363085125 -14400
# Node ID 6a40b8e7219a1603e38b4ff3dcc850b53d7cd218
# Parent  6ae71688f2c23c569d2a7cfc5ae39e06c6ec9cbd
Documented the "fastcgi_catch_stderr" directive.

diff --git a/xml/en/docs/http/ngx_http_fastcgi_module.xml b/xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -420,6 +420,32 @@ using the <link id="fastcgi_ignore_heade
 </directive>
 
 
+<directive name="fastcgi_catch_stderr">
+<syntax><value>string</value></syntax>
+<default/>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Sets a string to search for in the error stream of a response
+received from a FastCGI server.
+If the <value>string</value> is found then it is considered that the FastCGI
+server returned an <link id="fastcgi_next_upstream">invalid response</link>.
+This allows to handle application errors in nginx, for example:
+<example>
+location /php {
+    fastcgi_pass backend:9000;
+    ...
+    fastcgi_catch_stderr "PHP Fatal error";
+    fastcgi_next_upstream error timeout invalid_header;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_connect_timeout">
 <syntax><value>time</value></syntax>
 <default>60s</default>
diff --git a/xml/ru/docs/http/ngx_http_fastcgi_module.xml b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -418,6 +418,32 @@ fastcgi_cache_valid any      1m;
 </directive>
 
 
+<directive name="fastcgi_catch_stderr">
+<syntax><value>строка</value></syntax>
+<default/>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Задаёт строку для поиска в потоке ошибок ответа,
+полученного от FastCGI-сервера.
+Если <value>строка</value> найдена, то считается, что FastCGI-сервер
+вернул <link id="fastcgi_next_upstream">неверный ответ</link>.
+Это позволяет обрабатывать ошибки приложений в nginx, например:
+<example>
+location /php {
+    fastcgi_pass backend:9000;
+    ...
+    fastcgi_catch_stderr "PHP Fatal error";
+    fastcgi_next_upstream error timeout invalid_header;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_connect_timeout">
 <syntax><value>время</value></syntax>
 <default>60s</default>