fullstack.org.ua

Змінні середовища та файл .env · fullstack.org.ua

Початковий12 хв· Fullstack Team

Змінні середовища та файл .env

Розберете формат змінних середовища, файли .env і правила безпечного зберігання локальних налаштувань.

Що таке змінні середовища

Змінна середовища — це значення, яке програма отримує з оточення операційної системи під час запуску.

Зазвичай через змінні середовища зберігають:

порт застосунку;
адресу бази даних;
логін і пароль;
секретні ключі;
режим роботи застосунку;
адреси зовнішніх сервісів.

Такий підхід дає змогу не змінювати код під час переходу між середовищами:

локальна розробка;
тестування;
production.

Наприклад, код може бути однаковим, але локально застосунок підключається до однієї бази даних, а на сервері — до іншої.

У Node.js змінні середовища доступні через process.env:

typescript

const port = process.env.PORT;

console.log(port);

typescript

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,
    }),
  ],
})
export class AppModule {}

typescript

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppConfigService {
  constructor(private readonly configService: ConfigService) {}

  getPort(): number {
    const portValue = this.configService.get<string>('PORT') ?? '3000';
    const port = Number(portValue);

    if (!Number.isInteger(port) || port <= 0) {
      throw new Error('PORT має бути додатним цілим числом');
    }

    return port;
  }
}

typescript

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AppConfigService } from './app-config.service';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,
    }),
  ],
  providers: [AppConfigService],
  exports: [AppConfigService],
})
export class AppModule {}

typescript

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { AppConfigService } from './app-config.service';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  const config = app.get(AppConfigService);

  await app.listen(config.getPort());
}

bootstrap();

typescript

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AppConfigService } from './app-config.service';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,
    }),
  ],
  providers: [AppConfigService],
  exports: [AppConfigService],
})
export class AppModule {}

typescript

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppConfigService {
  constructor(private readonly configService: ConfigService) {}

  getPort(): number {
    const value = this.configService.get<string>('PORT') ?? '3000';
    const port = Number(value);

    if (!Number.isInteger(port) || port <= 0) {
      throw new Error('PORT має бути додатним цілим числом');
    }

    return port;
  }
}

typescript

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { AppConfigService } from './app-config.service';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  const config = app.get(AppConfigService);

  await app.listen(config.getPort());
}

bootstrap();