Что такое «Переменная окружения»

У каждого процесса в Linux, Windows и macOS есть окружение — набор строковых пар, унаследованный от родительского процесса. Командная оболочка, веб-сервер, контейнер передают его дальше. Механизм старый, он появился ещё в Unix, но второе дыхание получил с распространением облаков и Docker: один и тот же образ приложения запускают в разработке, на тестовом и боевом сервере, меняя только окружение. Этот принцип записан в методологии «Двенадцать факторов»: конфигурация хранится в окружении, а не в коде.

Обычная переменная существует внутри программы, а переменная окружения задаётся снаружи, ещё до запуска, и программа лишь получает её значение. Типичное содержимое: адрес и пароль базы данных, ключи API, режим работы (production или development).

Как задать и прочитать

export APP_ENV=staging                        # оболочка Linux
env[DB_PASSWORD] = s3cret                     ; пул PHP-FPM
$env = getenv( 'APP_ENV' ) ?: 'production';   // чтение в PHP

В Docker переменные передают через секцию environment или файл .env рядом с описанием сервисов, в контейнер они попадают при запуске. WordPress умеет брать тип среды из переменной WP_ENVIRONMENT_TYPE: функция wp_get_environment_type() вернёт local, development, staging или production. А параметры базы в wp-config.php можно читать через getenv() вместо того, чтобы вписывать пароль прямо в файл.

Подводные камни

  • PHP-FPM по умолчанию очищает окружение рабочих процессов (настройка clear_env), поэтому переменная, видимая в консоли, в PHP может оказаться пустой. Её нужно явно пробросить через env[...] в конфигурации пула.
  • Массив $_ENV часто пуст: в рекомендуемом php.ini директива variables_order не включает букву E. Надёжнее getenv().
  • Файл .env с паролями не должен попадать в репозиторий — его добавляют в .gitignore, а в репозиторий кладут пример без секретов.
  • Окружение видно всем процессам-потомкам и иногда попадает в отчёты об ошибках. Для особо чувствительных данных используют отдельные хранилища секретов.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Backend» ↗