<!-- review: finished -->

<a id="http-fastcgi"></a>

# FastCGI

Позволяет передавать запросы FastCGI-серверу.

<a id="configuration-example-14"></a>

## Пример конфигурации

```nginx
location / {
    fastcgi_pass  localhost:9000;
    fastcgi_index index.php;

    fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
    fastcgi_param QUERY_STRING    $query_string;
    fastcgi_param REQUEST_METHOD  $request_method;
    fastcgi_param CONTENT_TYPE    $content_type;
    fastcgi_param CONTENT_LENGTH  $content_length;
}
```

<a id="directives-15"></a>

## Директивы

<a id="index-0"></a>

<a id="fastcgi-bind"></a>

### fastcgi_bind

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_bind` адрес [`transparent`] | `off`;   |
|------------------------------------------------------------------------------------------|-------------------------------------------------|
| По умолчанию                                                                             | —                                               |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                          |

Задает локальный IP-адрес с необязательным портом, который будет использоваться в исходящих соединениях с FastCGI-сервером. В значении параметра допустимо использование переменных. Специальное значение `off` отменяет действие унаследованной с предыдущего уровня конфигурации директивы fastcgi_bind, позволяя системе самостоятельно выбирать локальный IP-адрес и порт.

Параметр `transparent` позволяет задать нелокальный IP-адрес, который будет использоваться в исходящих соединениях с FastCGI-сервером, например, реальный IP-адрес клиента:

```nginx
fastcgi_bind $remote_addr transparent;
```

Для работы параметра обычно требуется запустить рабочие процессы Angie с привилегиями [суперпользователя](https://angie.software//angie/docs/configuration/modules/core.md#user). В Linux это не требуется, так как если указан параметр transparent, то рабочие процессы наследуют capability CAP_NET_RAW из главного процесса.

#### NOTE
Необходимо настроить таблицу маршрутизации ядра для перехвата сетевого трафика с FastCGI-сервера.

<a id="index-1"></a>

<a id="fastcgi-buffer-size"></a>

### fastcgi_buffer_size

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_buffer_size` размер;   |
|------------------------------------------------------------------------------------------|---------------------------------|
| По умолчанию                                                                             | `fastcgi_buffer_size 4k|8k;`    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location          |

Задает размер буфера, в который будет читаться первая часть ответа, получаемого от FastCGI-сервера. В этой части ответа обычно находится небольшой заголовок ответа. По умолчанию размер одного буфера равен размеру страницы памяти. В зависимости от платформы это или 4K, или 8K, однако его можно сделать меньше.

<a id="index-2"></a>

<a id="fastcgi-buffering"></a>

### fastcgi_buffering

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_buffering` `on` | `off`;   |
|------------------------------------------------------------------------------------------|-------------------------------------|
| По умолчанию                                                                             | `fastcgi_buffering on;`             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location              |

Разрешает или запрещает использовать буферизацию ответов FastCGI-сервера.

| `on`   | Angie принимает ответ FastCGI-сервера как можно быстрее, сохраняя его в<br/>буферы, заданные директивами [fastcgi_buffer_size](#fastcgi-buffer-size) и<br/>[fastcgi_buffers](#fastcgi-buffers). Отправка клиенту при этом выполняется<br/>параллельно: заполненные буферы передаются на отправку (никто их не<br/>удерживает), но суммарно не более значения<br/>[fastcgi_busy_buffers_size](#fastcgi-busy-buffers-size). Если буфер заполнен не полностью, то<br/>на отправку он не передается, если только это не последние данные<br/>ответа. Поэтому для моментальной передачи каждых нескольких байт режим<br/>буферизированного чтения не подходит. Если ответ не вмещается целиком в<br/>память, то его часть может быть записана на диск во [временный файл](#fastcgi-temp-path). Запись во временные файлы контролируется<br/>директивами [fastcgi_max_temp_file_size](#fastcgi-max-temp-file-size) и<br/>[fastcgi_temp_file_write_size](#fastcgi-temp-file-write-size).   |
|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `off`  | Ответ передается клиенту сразу же по мере его поступления. Angie<br/>работает в цикле «прочитал — отправил» и не ждет, пока буфер заполнится<br/>целиком: например, прочитанные 10 байт из буфера 4К будут сразу<br/>отправлены клиенту. При этом если весь ответ умещается в буфер, Angie<br/>может прочитать его целиком. Максимальный размер данных, который Angie<br/>может принять от сервера за один раз, задается директивой<br/>[fastcgi_buffer_size](#fastcgi-buffer-size). При `off` не работает<br/>[fastcgi_limit_rate](#fastcgi-limit-rate).                                                                                                                                                                                                                                                                                                                                                                                                                           |

Буферизация может быть также включена или выключена путем передачи значения "yes" или "no" в поле `X-Accel-Buffering` заголовка ответа. Эту возможность можно запретить с помощью директивы [fastcgi_ignore_headers](#fastcgi-ignore-headers).

<a id="index-3"></a>

<a id="fastcgi-buffers"></a>

### fastcgi_buffers

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_buffers` число размер;   |
|------------------------------------------------------------------------------------------|-----------------------------------|
| По умолчанию                                                                             | `fastcgi_buffers 8 4k | 8k;`      |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location            |

Задает число и размер буферов для одного соединения, в которые будет читаться ответ, получаемый от FastCGI-сервера.

По умолчанию размер одного буфера равен размеру страницы. В зависимости от платформы это или 4K, или 8K.

<a id="index-4"></a>

<a id="fastcgi-busy-buffers-size"></a>

### fastcgi_busy_buffers_size

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_busy_buffers_size` размер;   |
|------------------------------------------------------------------------------------------|---------------------------------------|
| По умолчанию                                                                             | `fastcgi_busy_buffers_size 8k | 16k;` |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                |

При включенной [буферизации](#fastcgi-buffering) ответов FastCGI-сервера, ограничивает суммарный размер буферов, которые могут быть заняты для отправки ответа клиенту, пока ответ еще не прочитан целиком. Оставшиеся буферы тем временем могут использоваться для чтения ответа и, при необходимости, буферизации части ответа во временный файл. По умолчанию размер ограничен двумя буферами, заданными директивами [fastcgi_buffer_size](#fastcgi-buffer-size) и [fastcgi_buffers](#fastcgi-buffers).

<a id="index-5"></a>

<a id="fastcgi-cache"></a>

### fastcgi_cache

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache` зона | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------|
| По умолчанию                                                                             | `fastcgi_cache off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location          |

Задает зону разделяемой памяти, используемую для кэширования. Одна и та же зона может использоваться в нескольких местах. В значении параметра можно использовать переменные. Параметр `off` запрещает кэширование, унаследованное с предыдущего уровня конфигурации.

<a id="index-6"></a>

<a id="fastcgi-cache-background-update"></a>

### fastcgi_cache_background_update

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_background_update` `on` | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_background_update off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                            |

Позволяет запустить фоновый подзапрос для обновления просроченного элемента кэша, в то время как клиенту возвращается устаревший кэшированный ответ. Использование устаревшего кэшированного ответа в момент его обновления должно быть [разрешено](#fastcgi-cache-use-stale-updating).

<a id="index-7"></a>

<a id="fastcgi-cache-bypass"></a>

### fastcgi_cache_bypass

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_bypass` строка ...;   |
|------------------------------------------------------------------------------------------|--------------------------------------|
| По умолчанию                                                                             | —                                    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location               |

Задает условия, при которых ответ не будет браться из кэша. Если значение хотя бы одного из строковых параметров непустое и не равно "0", то ответ не берется из кэша:

```nginx
fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
fastcgi_cache_bypass $http_pragma    $http_authorization;
```

Можно использовать совместно с директивой [fastcgi_no_cache](#fastcgi-no-cache).

<a id="index-8"></a>

<a id="fastcgi-cache-key"></a>

### fastcgi_cache_key

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_key` строка;   |
|------------------------------------------------------------------------------------------|-------------------------------|
| По умолчанию                                                                             | —                             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location        |

Задает ключ для кэширования, например,

```nginx
fastcgi_cache_key localhost:9000$request_uri;
```

<a id="index-9"></a>

<a id="fastcgi-cache-lock"></a>

### fastcgi_cache_lock

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_lock` `on` | `off`;   |
|------------------------------------------------------------------------------------------|--------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_lock off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location               |

Если включено, одновременно только одному запросу будет позволено заполнить новый элемент кэша, идентифицируемый согласно директиве [fastcgi_cache_key](#fastcgi-cache-key), передав запрос на FastCGI-сервер. Остальные запросы этого же элемента будут либо ожидать появления ответа в кэше, либо освобождения блокировки этого элемента, в течение времени, заданного директивой [fastcgi_cache_lock_timeout](#fastcgi-cache-lock-timeout).

<a id="index-10"></a>

<a id="fastcgi-cache-lock-age"></a>

### fastcgi_cache_lock_age

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_lock_age` время;   |
|------------------------------------------------------------------------------------------|-----------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_lock_age 5s;`      |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location            |

Если последний запрос, переданный на FastCGI-сервер для заполнения нового элемента кэша, не завершился за указанное время, на FastCGI-сервер может быть передан еще один запрос.

<a id="index-11"></a>

<a id="fastcgi-cache-lock-timeout"></a>

### fastcgi_cache_lock_timeout

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_lock_timeout` время;   |
|------------------------------------------------------------------------------------------|---------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_lock_timeout 5s;`      |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                |

Задает таймаут для [fastcgi_cache_lock](#fastcgi-cache-lock). По истечении указанного времени запрос будет передан на FastCGI-сервер, однако ответ не будет кэширован.

<a id="index-12"></a>

<a id="fastcgi-cache-max-range-offset"></a>

### fastcgi_cache_max_range_offset

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_max_range_offset` число;   |
|------------------------------------------------------------------------------------------|-------------------------------------------|
| По умолчанию                                                                             | —                                         |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                    |

Задает смещение в байтах для запросов с указанием диапазона запрашиваемых байт (byte-range requests). Если диапазон находится за указанным смещением, range-запрос будет передан на FastCGI-сервер и ответ не будет кэширован.

<a id="index-13"></a>

<a id="fastcgi-cache-methods"></a>

### fastcgi_cache_methods

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_methods` `GET` | `HEAD` | `POST` ...;   |
|------------------------------------------------------------------------------------------|--------------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_methods GET HEAD;`                      |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                 |

Если метод запроса клиента указан в этой директиве, то ответ будет кэширован. Методы "GET" и "HEAD" всегда добавляются в список, но тем не менее рекомендуется перечислять их явно. См. также директиву [fastcgi_no_cache](#fastcgi-no-cache).

<a id="index-14"></a>

<a id="fastcgi-cache-min-uses"></a>

### fastcgi_cache_min_uses

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_min_uses` число;   |
|------------------------------------------------------------------------------------------|-----------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_min_uses 1;`       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location            |

Задает число запросов, после которого ответ будет кэширован.

#### WARNING
Метаданные кэша хранятся в разделяемой памяти. Ручное удаление файлов кэша не
сбрасывает счетчики и может привести к непредсказуемому поведению. Для
полного сброса остановите сервер, удалите директорию кэша и запустите снова.

#### NOTE
Сторонние модули очистки кэша (например, [Cache Purge](https://angie.software//angie/docs/installation/external-modules/cache-purge.md#external-cache-purge)) удаляют только
файлы, но не сбрасывают счетчик fastcgi_cache_min_uses. Директива
предназначена для защиты кэша от загрязнения редкими запросами, и сброс
счетчика при очистке может негативно повлиять на производительность.

<a id="index-15"></a>

<a id="fastcgi-cache-path"></a>

### fastcgi_cache_path

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_path` путь [`levels=`уровни] [`use_temp_path=``on` | `off`] `keys_zone=`имя:размер [`inactive=`время] [`max_size=`размер] [`min_free=`размер] [`manager_files=`число] [`manager_sleep=`время] [`manager_threshold=`время] [`loader_files=`число] [`loader_sleep=`время] [`loader_threshold=`время];   |
|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| По умолчанию                                                                             | —                                                                                                                                                                                                                                                                                                                    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                                                                                                                                                                                                                                                                               |

Задает путь и другие параметры кэша. Данные кэша хранятся в файлах. Ключом и именем файла в кэше является результат функции MD5 от проксированного URL.

Параметр `levels` задает уровни иерархии кэша: можно задать от 1 до 3 уровней, на каждом уровне допускаются значения 1 или 2. Например, при использовании

```nginx
fastcgi_cache_path /data/angie/cache levels=1:2 keys_zone=one:10m;
```

имена файлов в кэше будут такого вида:

```nginx
/data/angie/cache/c/29/b7f54b2df7773722d382f4809d65029c
```

Кэшируемый ответ сначала записывается во временный файл, а потом этот файл переименовывается. Временные файлы и кэш могут располагаться на разных файловых системах. Однако нужно учитывать, что в этом случае вместо дешевой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если кэш будет находиться на той же файловой системе, что и каталог с временными файлами.

Какой из каталогов будет использоваться для временных файлов определяется параметром `use_temp_path`.

| `on`   | Если параметр не задан или установлен в значение "on", будет использоваться каталог, задаваемый директивой [fastcgi_temp_path](#fastcgi-temp-path) для данного location.   |
|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `off`  | временные файлы будут располагаться непосредственно в каталоге кэша.                                                                                                       |

Кроме того, все активные ключи и информация о данных хранятся в зоне разделяемой памяти, имя и размер которой задаются параметром `keys_zone`. Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей. Метаданные кэша хранятся в разделяемой памяти.

Если к данным кэша не обращаются в течение времени, заданного параметром `inactive`, то данные удаляются, независимо от их свежести.

По умолчанию `inactive` равен 10 минутам.

Специальный процесс **менеджера кэша** следит за максимальным размером кэша, а также за минимальным объемом свободного места на файловой системе с кэшем, и удаляет наименее востребованные данные при превышении максимального размера кэша или недостаточном объеме свободного места. Удаление данных происходит итерациями.

| `max_size`          | максимальное пороговое значение размера кэша                                                           |
|---------------------|--------------------------------------------------------------------------------------------------------|
| `min_free`          | минимальное пороговое значение объема свободного места на файловой системе с кэшем                     |
| `manager_files`     | максимальное количество удаляемых элементов кэша за одну итерацию<br/><br/>По умолчанию: `100`         |
| `manager_threshold` | ограничивает время работы одной итерации<br/><br/>По умолчанию: `200` миллисекунд                      |
| `manager_sleep`     | время, в течение которого выдерживается пауза между итерациями<br/><br/>По умолчанию: `50` миллисекунд |

Через минуту после старта Angie активируется специальный процесс **загрузчика кэша**, который загружает в зону кэша информацию о ранее кэшированных данных, хранящихся на файловой системе. Загрузка также происходит итерациями.

| `loader_files`     | максимальное количество элементов кэша к загрузке в одну итерацию<br/><br/>По умолчанию: `100`         |
|--------------------|--------------------------------------------------------------------------------------------------------|
| `loader_threshold` | ограничивает время работы одной итерации<br/><br/>По умолчанию: `200` миллисекунд                      |
| `loader_sleep`     | время, в течение которого выдерживается пауза между итерациями<br/><br/>По умолчанию: `50` миллисекунд |

<a id="index-16"></a>

<a id="fastcgi-cache-revalidate"></a>

### fastcgi_cache_revalidate

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_revalidate` `on` | `off`;   |
|------------------------------------------------------------------------------------------|--------------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_revalidate off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                     |

Разрешает ревалидацию просроченных элементов кэша при помощи условных запросов с полями заголовка `If-Modified-Since`  и `If-None-Match` .

<a id="index-17"></a>

<a id="fastcgi-cache-use-stale"></a>

### fastcgi_cache_use_stale

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_use_stale` `error` | `timeout` | `invalid_header` | `updating` | `http_500` | `http_503` | `http_403` | `http_429` | `off` ...;   |
|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_cache_use_stale off;`                                                                                                                   |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                                                                                                           |

Определяет, в каких случаях можно использовать устаревший кэшированный ответ. Параметры директивы совпадают с параметрами директивы [fastcgi_next_upstream](#fastcgi-next-upstream).

| `error`    | позволяет использовать устаревший кэшированный ответ при невозможности выбора FastCGI-сервера для обработки запроса.                                                                                                         |
|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `updating` | дополнительный параметр, разрешает использовать устаревший кэшированный ответ, если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к FastCGI-серверам при обновлении кэшированных данных. |

Использование устаревшего кэшированного ответа может также быть разрешено непосредственно в заголовке ответа на определенное количество секунд после того, как ответ устарел.

* Расширение [stale-while-revalidate](https://datatracker.ietf.org/doc/html/rfc5861#section-3) поля заголовка `Cache-Control` разрешает использовать устаревший кэшированный ответ, если на данный момент он уже обновляется.
* Расширение [stale-if-error](https://datatracker.ietf.org/doc/html/rfc5861#section-4) поля заголовка `Cache-Control` разрешает использовать устаревший кэшированный ответ в случае ошибки.

#### NOTE
Такой способ менее приоритетен, чем задание параметров директивы.

Чтобы минимизировать число обращений к FastCGI-серверам при заполнении нового элемента кэша, можно воспользоваться директивой [fastcgi_cache_lock](#fastcgi-cache-lock).

<a id="index-18"></a>

<a id="fastcgi-cache-valid"></a>

### fastcgi_cache_valid

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_cache_valid` [код ...] время;   |
|------------------------------------------------------------------------------------------|------------------------------------------|
| По умолчанию                                                                             | —                                        |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                   |

Задает время кэширования для разных кодов ответа. Например, директивы

```nginx
fastcgi_cache_valid 200 302 10m;
fastcgi_cache_valid 404      1m;
```

задают время кэширования 10 минут для ответов с кодами 200 и 302 и 1 минуту для ответов с кодом 404.

Если указано только время кэширования,

```nginx
fastcgi_cache_valid 5m;
```

то кэшируются только ответы 200, 301 и 302.

Кроме того, можно кэшировать любые ответы с помощью параметра `any`:

```nginx
fastcgi_cache_valid 200 302 10m;
fastcgi_cache_valid 301      1h;
fastcgi_cache_valid any      1m;
```

#### NOTE
Параметры кэширования могут также быть заданы непосредственно в заголовке ответа. Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.

* Поле заголовка `X-Accel-Expires` задает время кэширования ответа в секундах. Значение 0 запрещает кэшировать ответ. Если значение начинается с префикса @, оно задает абсолютное время в секундах с начала эпохи, до которого ответ может быть кэширован.
* Если в заголовке нет поля `X-Accel-Expires`, параметры кэширования определяются по полям заголовка `Expires` или `Cache-Control`.
* Ответ, в заголовке которого есть поле `Set-Cookie`, не будет кэшироваться.
* Ответ, в заголовке которого есть поле `Vary` со специальным значением "\*", не будет кэшироваться. Ответ, в заголовке которого есть поле `Vary` с другим значением, будет кэширован с учетом соответствующих полей заголовка запроса.

Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы [fastcgi_ignore_headers](#fastcgi-ignore-headers).

<a id="index-19"></a>

<a id="fastcgi-catch-stderr"></a>

### fastcgi_catch_stderr

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_catch_stderr` строка;   |
|------------------------------------------------------------------------------------------|----------------------------------|
| По умолчанию                                                                             | —                                |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location           |

Задает строку для поиска в потоке ошибок ответа, полученного от FastCGI-сервера. Если строка найдена, то считается, что FastCGI-сервер вернул [неверный](#fastcgi-next-upstream) ответ. Это позволяет обрабатывать ошибки приложений в Angie, например:

```nginx
location /php/ {
    fastcgi_pass backend:9000;
    ...
    fastcgi_catch_stderr "PHP Fatal error";
    fastcgi_next_upstream error timeout invalid_header;
}
```

<a id="index-20"></a>

<a id="fastcgi-connect-timeout"></a>

### fastcgi_connect_timeout

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_connect_timeout` время;   |
|------------------------------------------------------------------------------------------|------------------------------------|
| По умолчанию                                                                             | `fastcgi_connect_timeout 60s;`     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location             |

Задает таймаут для установления соединения с FastCGI-сервером. Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.

<a id="index-21"></a>

<a id="fastcgi-connection-drop"></a>

### fastcgi_connection_drop

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_connection_drop` время | `on` | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_connection_drop off;`                    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                            |

Настраивает завершение всех соединений с проксируемым сервером,
если он был удален из группы или помечен как постоянно недоступный
в результате процесса [reresolve](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#reresolve)
или [команды API](https://angie.software//angie/docs/configuration/modules/http/http_api.md#api-config-methods) `DELETE`.

Соединение завершается, когда обрабатывается следующее событие чтения или записи
для клиента или проксируемого сервера.

Установка времени включает [таймаут](https://angie.software//angie/docs/configuration/configfile.md#syntax) до завершения соединения;
при выборе значения `on` соединения завершаются немедленно.

<a id="index-22"></a>

<a id="fastcgi-force-ranges"></a>

### fastcgi_force_ranges

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_force_ranges` `on` | `off`;   |
|------------------------------------------------------------------------------------------|----------------------------------------|
| По умолчанию                                                                             | `fastcgi_force_ranges off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                 |

Включает поддержку диапазонов запрашиваемых байт (byte-range) для кэшированных и некэшированных ответов FastCGI-сервера вне зависимости от наличия поля `Accept-Ranges` в заголовках этих ответов.

<a id="index-23"></a>

<a id="fastcgi-hide-header"></a>

### fastcgi_hide_header

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_hide_header` поле;   |
|------------------------------------------------------------------------------------------|-------------------------------|
| По умолчанию                                                                             | —                             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location        |

По умолчанию Angie не передает клиенту поля заголовка `Status` и `X-Accel-...` из ответа FastCGI-сервера. Директива fastcgi_hide_header задает дополнительные поля, которые не будут передаваться. Если же передачу полей нужно разрешить, можно воспользоваться директивой [fastcgi_pass_header](#fastcgi-pass-header).

<a id="index-24"></a>

<a id="fastcgi-ignore-client-abort"></a>

### fastcgi_ignore_client_abort

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_ignore_client_abort` `on` | `off`;   |
|------------------------------------------------------------------------------------------|-----------------------------------------------|
| По умолчанию                                                                             | `fastcgi_ignore_client_abort off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                        |

Определяет, закрывать ли соединение с FastCGI-сервером в случае, если клиент закрыл соединение, не дождавшись ответа.

<a id="index-25"></a>

<a id="fastcgi-ignore-headers"></a>

### fastcgi_ignore_headers

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_ignore_headers` поле;   |
|------------------------------------------------------------------------------------------|----------------------------------|
| По умолчанию                                                                             | —                                |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location           |

Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера. В директиве можно указать поля `X-Accel-Redirect`, `X-Accel-Expires`, `X-Accel-Limit-Rate`, `X-Accel-Buffering`, `X-Accel-Charset`, `Expires`, `Cache-Control`, `Set-Cookie` и `Vary`.

Если не запрещено, обработка этих полей заголовка заключается в следующем:

* `X-Accel-Expires`, `Expires`, `Cache-Control`, `Set-Cookie` и `Vary` задают [параметры кэширования](#fastcgi-cache-valid) ответа;
* `X-Accel-Redirect` производит [внутреннее перенаправление](https://angie.software//angie/docs/configuration/modules/http/index.md#internal) на указанный URI;
* `X-Accel-Limit-Rate` задает [ограничение скорости](https://angie.software//angie/docs/configuration/modules/http/index.md#limit-rate) передачи ответа клиенту;
* `X-Accel-Buffering` включает или выключает [буферизацию](#fastcgi-buffering) ответа;
* `X-Accel-Charset` задает желаемую [кодировку](https://angie.software//angie/docs/configuration/modules/http/http_charset.md#id3) ответа.

<a id="index-26"></a>

<a id="fastcgi-index"></a>

### fastcgi_index

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_index` имя;   |
|------------------------------------------------------------------------------------------|------------------------|
| По умолчанию                                                                             | —                      |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location |

Задает имя файла, который при создании переменной [$fastcgi_script_name](#v-fastcgi-script-name) будет добавляться после URI, если URI заканчивается косой чертой. Например, при таких настройках

```nginx
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
```

и запросе `/page.php` параметр SCRIPT_FILENAME будет равен `/home/www/scripts/php/page.php`,

а при запросе `/` - `/home/www/scripts/php/index.php`.

<a id="index-27"></a>

<a id="fastcgi-intercept-errors"></a>

### fastcgi_intercept_errors

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_intercept_errors` `on` | `off`;   |
|------------------------------------------------------------------------------------------|--------------------------------------------|
| По умолчанию                                                                             | `fastcgi_intercept_errors off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                     |

Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом больше либо равным 300, или же перехватывать их и перенаправлять на обработку Angie с помощью директивы [error_page](https://angie.software//angie/docs/configuration/modules/http/index.md#error-page).

<a id="index-28"></a>

<a id="fastcgi-keep-conn"></a>

### fastcgi_keep_conn

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_keep_conn` `on` | `off`;   |
|------------------------------------------------------------------------------------------|-------------------------------------|
| По умолчанию                                                                             | `fastcgi_keep_conn off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location              |

По умолчанию FastCGI-сервер будет закрывать соединение сразу же после отправки ответа. При установке значения `on` Angie указывает FastCGI-серверу оставлять соединения открытыми. Это в частности требуется для функционирования [постоянных соединений](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-keepalive) с FastCGI-серверами.

<a id="index-29"></a>

<a id="fastcgi-limit-rate"></a>

### fastcgi_limit_rate

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_limit_rate` скорость;   |
|------------------------------------------------------------------------------------------|----------------------------------|
| По умолчанию                                                                             | `fastcgi_limit_rate 0;`          |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location           |

Ограничивает скорость чтения ответа от проксируемого сервера.
Скорость задается в байтах в секунду; можно использовать переменные.

| `0`   | отключает ограничение скорости   |
|-------|----------------------------------|

#### NOTE
Ограничение устанавливается на запрос, поэтому, если Angie одновременно откроет два соединения к FastCGI-серверу, суммарная скорость будет вдвое выше заданного ограничения. Ограничение работает только в случае, если включена [буферизация](#fastcgi-buffering) ответов FastCGI-сервера.

<a id="index-30"></a>

<a id="fastcgi-max-temp-file-size"></a>

### fastcgi_max_temp_file_size

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_max_temp_file_size` размер;   |
|------------------------------------------------------------------------------------------|----------------------------------------|
| По умолчанию                                                                             | `fastcgi_max_temp_file_size 1024m;`    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                 |

Если включена [буферизация](#fastcgi-buffering) ответов FastCGI-сервера, и ответ не вмещается целиком в буферы, заданные директивами [fastcgi_buffer_size](#fastcgi-buffer-size) и [fastcgi_buffers](#fastcgi-buffers), часть ответа может быть записана во временный файл. Эта директива задает максимальный размер временного файла. Размер данных, сбрасываемых во временный файл за один раз, задается директивой [fastcgi_temp_file_write_size](#fastcgi-temp-file-write-size).

| `0`   | отключает возможность буферизации ответов во временные файлы   |
|-------|----------------------------------------------------------------|

#### NOTE
Данное ограничение не распространяется на ответы, которые будут [кэшированы](#fastcgi-cache) или сохранены [на диске](#fastcgi-store).

<a id="index-31"></a>

<a id="fastcgi-next-upstream"></a>

### fastcgi_next_upstream

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_next_upstream` `error` | `timeout` | `invalid_header` | `http_500` | `http_503` | `http_403` | `http_404` | `http_429` | `non_idempotent` | `off` ...;   |
|------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_next_upstream error timeout;`                                                                                                                            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                                                                                                                            |

Определяет, в каких случаях запрос будет передан следующему серверу:

| `error`          | произошла ошибка соединения с сервером, передачи ему запроса или чтения заголовка ответа сервера;                                                                                                                                                                        |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `timeout`        | произошел таймаут во время соединения с сервером, передачи ему запроса или чтения заголовка ответа сервера;                                                                                                                                                              |
| `invalid_header` | сервер вернул пустой или неверный ответ;                                                                                                                                                                                                                                 |
| `http_500`       | сервер вернул ответ с кодом 500;                                                                                                                                                                                                                                         |
| `http_503`       | сервер вернул ответ с кодом 503;                                                                                                                                                                                                                                         |
| `http_403`       | сервер вернул ответ с кодом 403;                                                                                                                                                                                                                                         |
| `http_404`       | сервер вернул ответ с кодом 404;                                                                                                                                                                                                                                         |
| `http_429`       | сервер вернул ответ с кодом 429;                                                                                                                                                                                                                                         |
| `non_idempotent` | обычно запросы с [неидемпотентным](https://datatracker.ietf.org/doc/html/rfc7231#section-4.2.2) методом (POST, LOCK, PATCH) не передаются на другой сервер, если запрос серверу группы уже был отправлен; включение параметра явно разрешает повторять подобные запросы; |
| `off`            | запрещает передачу запроса следующему серверу.                                                                                                                                                                                                                           |

#### NOTE
Необходимо понимать, что передача запроса следующему серверу возможна только при условии, что клиенту еще ничего не передавалось. То есть, если ошибка или таймаут возникли в середине передачи ответа, то исправить это уже невозможно.

Директива также определяет, что считается [неудачной попыткой](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#max-fails) работы с сервером.

| `error`<br/><br/>`timeout`<br/><br/>`invalid_header`   | всегда считаются неудачными попытками, даже если они не указаны в директиве   |
|--------------------------------------------------------|-------------------------------------------------------------------------------|
| `http_500`<br/><br/>`http_503`<br/><br/>`http_429`     | считаются неудачными попытками, только если они указаны в директиве           |
| `http_403`<br/><br/>`http_404`                         | никогда не считаются неудачными попытками                                     |

Передача запроса следующему серверу может быть ограничена по [количеству попыток](#fastcgi-next-upstream-tries) и по [времени](#fastcgi-next-upstream-timeout).

<a id="index-32"></a>

<a id="fastcgi-next-upstream-timeout"></a>

### fastcgi_next_upstream_timeout

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_next_upstream_timeout` время;   |
|------------------------------------------------------------------------------------------|------------------------------------------|
| По умолчанию                                                                             | `fastcgi_next_upstream_timeout 0;`       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                   |

Ограничивает время, в течение которого возможна передача запроса [следующему серверу](#fastcgi-next-upstream).

| `0`   | отключает это ограничение   |
|-------|-----------------------------|

<a id="index-33"></a>

<a id="fastcgi-next-upstream-tries"></a>

### fastcgi_next_upstream_tries

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_next_upstream_tries` число;   |
|------------------------------------------------------------------------------------------|----------------------------------------|
| По умолчанию                                                                             | `fastcgi_next_upstream_tries 0;`       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                 |

Ограничивает число допустимых попыток для передачи запроса [следующему серверу](#fastcgi-next-upstream).

| `0`   | отключает это ограничение   |
|-------|-----------------------------|

<a id="index-34"></a>

<a id="fastcgi-no-cache"></a>

### fastcgi_no_cache

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_no_cache` строка ...;   |
|------------------------------------------------------------------------------------------|----------------------------------|
| По умолчанию                                                                             | —                                |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location           |

Задает условия, при которых ответ не будет сохраняться в кэш. Если значение хотя бы одного из строковых параметров непустое и не равно "0", то ответ не будет сохранен:

```nginx
fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
fastcgi_no_cache $http_pragma    $http_authorization;
```

Можно использовать совместно с директивой [fastcgi_cache_bypass](#fastcgi-cache-bypass).

<a id="index-35"></a>

<a id="fastcgi-param"></a>

### fastcgi_param

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_param` параметр значение [`if_not_empty`];   |
|------------------------------------------------------------------------------------------|-------------------------------------------------------|
| По умолчанию                                                                             | —                                                     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                |

Задает параметр, который будет передаваться FastCGI-серверу. В качестве значения можно использовать текст, переменные и их комбинации. Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы fastcgi_param.

#### NOTE
В стандартных файлах `fastcgi.conf` и `fastcgi_params`, поставляемых
с Angie, параметр `REQUEST_METHOD` задаётся как
`$upstream_request_method`. Это позволяет при конвертации
`HEAD` в `GET` при кэшировании использовать корректный метод
для запроса к upstream.

Ниже приведен пример минимально необходимых параметров для PHP:

```nginx
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
fastcgi_param QUERY_STRING    $query_string;
```

Параметр SCRIPT_FILENAME используется в PHP для определения имени скрипта, а в параметре QUERY_STRING передаются параметры запроса.

Если скрипты обрабатывают запросы POST, то нужны еще три параметра:

```nginx
fastcgi_param REQUEST_METHOD  $request_method;
fastcgi_param CONTENT_TYPE    $content_type;
fastcgi_param CONTENT_LENGTH  $content_length;
```

Если PHP был собран с параметром конфигурации `--enable-force-cgi-redirect`, то нужно передавать параметр REDIRECT_STATUS со значением "200":

```nginx
fastcgi_param REDIRECT_STATUS 200;
```

Если директива указана с `if_not_empty`, такой параметр с пустым значением передаваться на сервер не будет:

```nginx
fastcgi_param HTTPS           $https if_not_empty;
```

<a id="index-36"></a>

<a id="fastcgi-pass"></a>

### fastcgi_pass

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_pass` адрес;   |
|------------------------------------------------------------------------------------------|-------------------------|
| По умолчанию                                                                             | —                       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | location, if в location |

Задает адрес FastCGI-сервера. Адрес может быть указан в виде доменного имени или IP-адреса, и порта:

```nginx
fastcgi_pass localhost:9000;
```

или в виде пути UNIX-сокета:

```nginx
fastcgi_pass unix:/tmp/fastcgi.socket;
```

Если доменному имени соответствует несколько адресов, то все они будут использоваться по очереди (round-robin). И, кроме того, адрес может быть [группой серверов](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream).

В значении параметра можно использовать переменные. В этом случае, если адрес указан в виде доменного имени, имя ищется среди описанных [групп серверов](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream) и если не найдено, то определяется с помощью [resolver](https://angie.software//angie/docs/configuration/modules/http/index.md#resolver)'а.

#### NOTE
Если `fastcgi_pass` стоит в `location` с косой чертой в конце префикса
(например, `location /name/`),
и при этом в директиве [auto_redirect](https://angie.software//angie/docs/configuration/modules/http/index.md#auto-redirect) указано `default`,
запросы без косой черты в конце будут перенаправляться (`/name -> /name/`).

<a id="index-37"></a>

<a id="fastcgi-pass-header"></a>

### fastcgi_pass_header

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_pass_header` поле;   |
|------------------------------------------------------------------------------------------|-------------------------------|
| По умолчанию                                                                             | —                             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location        |

Разрешает передавать от FastCGI-сервера клиенту [запрещенные для передачи](#fastcgi-hide-header) поля заголовка.

<a id="index-38"></a>

<a id="fastcgi-pass-request-body"></a>

### fastcgi_pass_request_body

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_pass_request_body` `on` | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------------------|
| По умолчанию                                                                             | —                                           |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                      |

Позволяет запретить передачу исходного тела запроса на FastCGI-сервер. См. также директиву [fastcgi_pass_request_headers](#fastcgi-pass-request-headers).

<a id="index-39"></a>

<a id="fastcgi-pass-request-headers"></a>

### fastcgi_pass_request_headers

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_pass_request_headers` `on` | `off`;   |
|------------------------------------------------------------------------------------------|------------------------------------------------|
| По умолчанию                                                                             | —                                              |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                         |

Позволяет запретить передачу полей заголовка исходного запроса на FastCGI-сервер. См. также директиву [fastcgi_pass_request_body](#fastcgi-pass-request-body).

<a id="index-40"></a>

<a id="fastcgi-read-timeout"></a>

### fastcgi_read_timeout

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_read_timeout` время;   |
|------------------------------------------------------------------------------------------|---------------------------------|
| По умолчанию                                                                             | `fastcgi_read_timeout 60s;`     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location          |

Задает таймаут при чтении ответа FastCGI-сервера. Таймаут устанавливается не на всю передачу ответа, а только между двумя операциями чтения. Если по истечении этого времени FastCGI-сервер ничего не передаст, соединение закрывается.

<a id="index-41"></a>

<a id="fastcgi-request-buffering"></a>

### fastcgi_request_buffering

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_request_buffering` `on` | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------------------|
| По умолчанию                                                                             | `fastcgi_request_buffering on;`             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                      |

Разрешает или запрещает использовать буферизацию тела запроса клиента.

| `on`   | тело запроса полностью [читается](https://angie.software//angie/docs/configuration/modules/http/index.md#client-body-buffer-size) от клиента перед отправкой запроса на FastCGI-сервер.                            |
|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `off`  | тело запроса отправляется на FastCGI-сервер сразу же по мере его поступления. В этом случае запрос не может быть передан [следующему серверу](#fastcgi-next-upstream), если Angie уже начал отправку тела запроса. |

<a id="index-42"></a>

<a id="fastcgi-send-lowat"></a>

### fastcgi_send_lowat

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_send_lowat` размер;   |
|------------------------------------------------------------------------------------------|--------------------------------|
| По умолчанию                                                                             | `fastcgi_send_lowat 0;`        |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location         |

При установке директивы в ненулевое значение Angie будет пытаться
минимизировать число операций отправки на исходящих соединениях с
FastCGI-сервером либо при помощи флага `NOTE_LOWAT` метода [kqueue](https://angie.software//angie/docs/configuration/processing.md#kqueue), либо при помощи параметра сокета `SO_SNDLOWAT`, с указанным
размером.

#### NOTE
Эта директива игнорируется на Linux, Solaris и Windows.

<a id="index-43"></a>

<a id="fastcgi-send-timeout"></a>

### fastcgi_send_timeout

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_send_timeout` время;   |
|------------------------------------------------------------------------------------------|---------------------------------|
| По умолчанию                                                                             | `fastcgi_send_timeout 60s;`     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location          |

Задает таймаут при передаче запроса FastCGI-серверу. Таймаут устанавливается не на всю передачу запроса, а только между двумя операциями записи. Если по истечении этого времени FastCGI-сервер не примет новых данных, соединение закрывается.

<a id="index-44"></a>

<a id="fastcgi-socket-keepalive"></a>

### fastcgi_socket_keepalive

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_socket_keepalive` `on` | `off`;   |
|------------------------------------------------------------------------------------------|--------------------------------------------|
| По умолчанию                                                                             | `fastcgi_socket_keepalive off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                     |

Конфигурирует поведение "TCP keepalive" для исходящих соединений к FastCGI-серверу.

| `""`   | По умолчанию для сокета действуют настройки операционной системы.   |
|--------|---------------------------------------------------------------------|
| `on`   | для сокета включается параметр SO_KEEPALIVE                         |

<a id="index-45"></a>

<a id="fastcgi-split-path-info"></a>

### fastcgi_split_path_info

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_split_path_info` regex;   |
|------------------------------------------------------------------------------------------|------------------------------------|
| По умолчанию                                                                             | —                                  |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | location                           |

Задает регулярное выражение, выделяющее значение для переменной [$fastcgi_path_info](#v-fastcgi-path-info). Регулярное выражение должно иметь две группы захвата, из которых первая становится значением переменной [$fastcgi_script_name](#v-fastcgi-script-name), а вторая — значением переменной [$fastcgi_path_info](#v-fastcgi-path-info). Например, при таких настройках

```default
location ~ ^(.+\.php)(.*)$ {
    fastcgi_split_path_info       ^(.+\.php)(.*)$;
    fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
    fastcgi_param PATH_INFO       $fastcgi_path_info;
```

и запросе `/show.php/article/0001` параметр SCRIPT_FILENAME будет равен `/path/to/php/show.php`,

а параметр PATH_INFO - `/article/0001`.

<a id="index-46"></a>

<a id="fastcgi-store"></a>

### fastcgi_store

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_store` `on` | `off` | строка;   |
|------------------------------------------------------------------------------------------|------------------------------------------|
| По умолчанию                                                                             | `fastcgi_store off;`                     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                   |

Разрешает сохранение на диск файлов.

| `on`   | сохраняет файлы в соответствии с путями, указанными в директивах [alias](https://angie.software//angie/docs/configuration/modules/http/index.md#alias) или [root](https://angie.software//angie/docs/configuration/modules/http/index.md#root)   |
|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `off`  | запрещает сохранение файлов                                                                                                                                                                                                                      |

Кроме того, имя файла можно задать явно с помощью строки с переменными:

```nginx
fastcgi_store /data/www$original_uri;
```

Время изменения файлов выставляется согласно полученному полю `Last-Modified` в заголовке ответа. Ответ сначала записывается во временный файл, а потом этот файл переименовывается. Временный файл и постоянное место хранения ответа могут располагаться на разных файловых системах. Однако нужно учитывать, что в этом случае вместо дешевой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой системе, что и каталог с временными файлами, задаваемый директивой [fastcgi_temp_path](#fastcgi-temp-path) для данного location.

Директиву можно использовать для создания локальных копий статических неизменяемых файлов, например:

```nginx
location /images/ {
    root                 /data/www;
    error_page           404 = /fetch$uri;
}

location /fetch/ {
    internal;

    fastcgi_pass         backend:9000;
    ...

    fastcgi_store        on;
    fastcgi_store_access user:rw group:rw all:r;
    fastcgi_temp_path    /data/temp;

    alias                /data/www/;
}
```

<a id="index-47"></a>

<a id="fastcgi-store-access"></a>

### fastcgi_store_access

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_store_access` пользователи:права ...;   |
|------------------------------------------------------------------------------------------|--------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_store_access user:rw;`                  |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                           |

Задает права доступа для создаваемых файлов и каталогов, например,

```nginx
fastcgi_store_access user:rw group:rw all:r;
```

Если заданы какие-либо права для group или all, то права для user указывать необязательно:

```nginx
fastcgi_store_access group:rw all:r;
```

<a id="index-48"></a>

<a id="fastcgi-temp-file-write-size"></a>

### fastcgi_temp_file_write_size

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_temp_file_write_size` размер;   |
|------------------------------------------------------------------------------------------|------------------------------------------|
| По умолчанию                                                                             | `fastcgi_temp_file_write_size 8k|16k;`   |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                   |

Ограничивает размер данных, сбрасываемых во временный файл за один раз, при включенной буферизации ответов FastCGI-сервера во временные файлы. По умолчанию размер ограничен двумя буферами, заданными директивами [fastcgi_buffer_size](#fastcgi-buffer-size) и [fastcgi_buffers](#fastcgi-buffers). Максимальный размер временного файла задается директивой [fastcgi_max_temp_file_size](#fastcgi-max-temp-file-size).

<a id="index-49"></a>

<a id="fastcgi-temp-path"></a>

### fastcgi_temp_path

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `fastcgi_temp_path` путь [уровень1 [уровень2 [уровень3]]]\`;                                                                                                                |
|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| По умолчанию                                                                             | `fastcgi_temp_path fastcgi_temp;`<br/>(путь зависит от [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#paths) `--http-fastcgi-temp-path`) |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                                                                                                                                                      |

Задает имя каталога для хранения временных файлов с данными, полученными от FastCGI-серверов. В каталоге может использоваться иерархия подкаталогов до трех уровней. Например, при такой конфигурации

```nginx
fastcgi_temp_path /spool/angie/fastcgi_temp 1 2;
```

временный файл будет следующего вида:

```nginx
/spool/angie/fastcgi_temp/7/45/00000123457
```

См. также параметр use_temp_path директивы [fastcgi_cache_path](#fastcgi-cache-path).

<a id="parameters-passed-to-a-fastcgi-server"></a>

## Параметры, передаваемые FastCGI-серверу

Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров. В приложениях и скриптах, запущенных в виде FastCGI-сервера, эти параметры обычно доступны в виде переменных среды. Например, поле заголовка `User-Agent` передается как параметр HTTP_USER_AGENT. Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры с помощью директивы [fastcgi_param](#fastcgi-param).

<a id="built-in-variables"></a>

## Встроенные переменные

В модуле http_fastcgi есть встроенные переменные, которые можно использовать для формирования параметров с помощью директивы [fastcgi_param](#fastcgi-param):

<a id="v-fastcgi-script-name"></a>

### `$fastcgi_script_name`

URI запроса или же, если URI заканчивается косой чертой, то URI запроса, дополненное именем индексного файла, задаваемого директивой [fastcgi_index](#fastcgi-index). Эту переменную можно использовать для задания параметров SCRIPT_FILENAME и PATH_TRANSLATED, используемых, в частности, для определения имени скрипта в PHP. Например, для запроса `/info/` и при использовании директив

```nginx
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
```

параметр SCRIPT_FILENAME будет равен `/home/www/scripts/php/info/index.php`.

При использовании директивы [fastcgi_split_path_info](#fastcgi-split-path-info) переменная $fastcgi_script_name равна значению первой группы захвата, задаваемой этой директивой.

<a id="v-fastcgi-path-info"></a>

### `$fastcgi_path_info`

значение второй группы захвата, задаваемой директивой [fastcgi_split_path_info](#fastcgi-split-path-info). Эту переменную можно использовать для задания параметра PATH_INFO.