Переменные окружения (environment variables) — это настройки приложения, которые хранятся вне кода и подставляются при запуске: адреса, пароли, ключи API, режим работы. Благодаря им один и тот же код работает по-разному на тестовом и боевом сервере.
Каждая переменная — пара «имя и значение»: например, адрес базы данных или ключ платёжной системы. Приложение читает их при старте. Так секреты не попадают в репозиторий, а смена настройки не требует правки кода. Переменные удобно хранить в файле .env, который не добавляют в Git, и задавать в панели хостинга или системы выкладки.
Этот подход — часть правил, известных как «двенадцатифакторное приложение», и стал стандартом для современных сайтов и сервисов.
Пример
Магазину нужны разные данные для платёжной системы: тестовые ключи для проверки и боевые для живых платежей. В коде написано «взять ключ из переменной PAYMENT_KEY». В тестовом окружении в ней лежит тестовый ключ, в боевом — настоящий.
Что хранят в переменных
- Пароли и адреса баз данных.
- Ключи API сторонних сервисов: платежи, почта, карты.
- Секреты для подписи сессий и токенов.
- Адрес сайта и режим работы (разработка или боевой).
- Включение и отключение функций.
Как работать с ними безопасно
- Добавьте файл
.envв список игнорируемых файлов Git. - Положите в репозиторий пример
.env.exampleбез настоящих значений. - Задавайте боевые значения прямо на сервере или в панели хостинга.
- Давайте доступ к секретам только тем, кому он нужен.
- Если ключ попал в репозиторий, немедленно перевыпустите его.
Типичные ошибки
- Пароли и ключи прописывают прямо в код.
- В открытую часть сайта, видимую браузеру, попадают секретные ключи.
- Не документируют, какие переменные нужны, и новый разработчик не может запустить проект.
- Забывают задать переменные после переезда на другой сервер.
Кому и когда это нужно
Переменные окружения нужны любому проекту с кодом, который работает с паролями, ключами или разными серверами. Для заказчика это вопрос безопасности: спросите подрядчика, где хранятся ключи платёжной системы и доступы к базе, и кто их видит. Если ответ «в коде» или «в чате», это повод немедленно навести порядок и перевыпустить ключи.
Частый вопрос
Почему нельзя хранить пароли в коде? Код попадает в репозиторий, к подрядчикам и в резервные копии, а значит, пароль может утечь. Кроме того, его придётся менять во всех местах при смене. Переменные окружения решают обе проблемы: секреты лежат отдельно и под контролем.