﻿---
path: administration/action-history/php-fpm-logging.mdx
title: PHP-FPM логирование
slug: php-fpm-logging
pagination_next: null
pagination_prev: null
description: >-
  Техническое описание логирования stdout/stderr и error_log в PHP-FPM для
  корректной настройки логирования событий Истории действий Пассворка.
keywords:
  - Пассворк
  - PHP-FPM
  - master process
  - worker processes
  - catch_workers_output
  - error_log
  - stdout
  - stderr
  - SIEM
  - CEF
---

## Базовая модель PHP-FPM

- **Мастер процесс** — управляет пулом PHP-FPM и ведёт основной `error_log`.
- **Воркер процессы** — обслуживают FastCGI-запросы Пассворка и формируют ошибки или предупреждения PHP.

## `catch_workers_output`

Перенаправляет вывод (`stdout` и `stderr`) воркеров в поток мастер процесса или файл лога. Значение задаётся в параметре `error_log` конфигурационного файла `php-fpm.conf`.

Возможные значения:

- `yes` — `stdout` и `stderr` воркеров перенаправляются в поток или файл, заданный в `error_log`;
- `no` (по умолчанию) —  вывод воркеров перенаправляется в `/dev/null` (по спецификации FastCGI).

Используется в настройке контейнерных сред для сбора и передачи событий в `stdout`/`stderr` через `error_log`.

## `error_log`

Значение параметра `error_log` (в конфигурационном файле `php-fpm.conf`) задаёт, куда PHP-FPM записывает логи:

- файл (например, `/var/log/php-fpm.log`);
- `syslog` для отправки в `syslogd`;
- поток (например, `/dev/stderr`).

Если `error_log` направлен в поток (например, `/dev/stderr` или `/proc/self/fd/2`), то перехваченный вывод воркеров также попадает в поток логов контейнера.

## История действий в Пассворке

Для **Истории действий** значение параметра `ACTIVITY_LOG_OUTPUT` задаёт канал вывода:

- `syslog` — логирование действий через syslog;
- `stdout` — логирование действий в поток PHP-FPM.