0Pricing
PHP Academy · 강의

환경 변수 및 .env 파일

PHP의 .env 파일과 dotenv 라이브러리로 민감한 설정을 관리합니다.

환경 변수 및 .env 파일은(는) CoddyKit의 무료 PHP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 PHP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환경 변수를 사용하는 이유

소스 코드에 인증 정보나 환경별 구성을 하드코딩하면 안전하지 않고 배포가 불안정해집니다. 환경 변수는 구성과 코드를 분리합니다.

.env 파일

.env 파일에는 부팅 시 환경에 로드되는 키-값 쌍이 들어 있습니다. .gitignore에 추가하십시오. 버전 관리에 NEVER 커밋하지 마십시오.

# .env
APP_ENV=production
APP_KEY=base64:...
DB_HOST=127.0.0.1
DB_NAME=myapp
DB_USER=myapp_user
DB_PASS=supersecret

REDIS_HOST=127.0.0.1
MAIL_HOST=smtp.mailtrap.io

Laravel의 .env 통합

Laravel은 vlucas/phpdotenv를 사용하여 .env를 자동으로 로드합니다. env() 도우미로 값을 읽을 수 있습니다.

<?php
$host = env("DB_HOST", "127.0.0.1"); // "127.0.0.1" is the default

config()와 env() 비교

env()는 config/*.php 파일에서만 사용하십시오. 그 외의 모든 곳에서는 config("database.host")를 사용하십시오. 이렇게 해야 구성 캐싱에서도 올바르게 작동합니다.

<?php
// In config/database.php:
"host" => env("DB_HOST", "127.0.0.1")

// In your service classes:
$host = config("database.connections.mysql.host");

구성 캐싱

모든 요청마다 .env를 구문 분석하지 않도록 운영 환경에서는 구성을 캐시하십시오.

$ php artisan config:cache
# After changing .env:
$ php artisan config:clear

Laravel 외부에서 phpdotenv 사용

Laravel 외부에서는 vlucas/phpdotenv를 사용하십시오.

$ composer require vlucas/phpdotenv

<?php
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
$host = $_ENV["DB_HOST"];

필수 변수

부팅 시 필수 환경 변수를 확인하여 누락된 구성을 일찍 발견하십시오.

<?php
$dotenv->required(["DB_HOST", "DB_NAME", "DB_USER", "DB_PASS"]);
$dotenv->required(["DB_PORT"])->isInteger();

.env.example 파일

모든 변수 이름을 포함하되 값은 포함하지 않는 .env.example 파일을 커밋하십시오. 개발자는 이 파일을 .env로 복사한 후 자신의 값을 입력합니다.

서버 수준 환경 변수

운영 환경에서는 .env 파일 대신 서버 수준에서 환경 변수를 설정하십시오(systemd 서비스 파일, Docker --env 플래그, Kubernetes 보안 비밀 등).

# systemd service:
[Service]
Environment="APP_ENV=production"
Environment="DB_HOST=db.internal"

보안 비밀 관리

민감한 인증 정보(API 키, 인증서)에는 보안 비밀 관리자를 사용하십시오. 예를 들어 HashiCorp Vault, AWS Secrets Manager 또는 CI용 GitHub Actions 보안 비밀을 사용할 수 있습니다.

요약

모든 환경별 구성을 .env에 저장하십시오. NEVER 커밋하지 마십시오. 애플리케이션 코드에서는 config()를 사용하고, env()는 구성 파일에서만 사용하십시오. 운영 환경에서는 php artisan config:cache로 구성을 캐시하십시오.

빠른 확인

Laravel 앱에서 env()는 어디에서 호출해야 합니까?

자주 묻는 질문

“환경 변수 및 .env 파일” 강의는 무료인가요?

네 — “환경 변수 및 .env 파일” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 PHP Academy 강의 전체를 잠금 해제할 수 있습니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“환경 변수 및 .env 파일”에서 뭘 배우나요?

PHP의 .env 파일과 dotenv 라이브러리로 민감한 설정을 관리합니다. 브라우저에서 직접 실행하는 실습 코드로 PHP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

PHP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 PHP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“환경 변수 및 .env 파일” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 PHP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 PHP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Nginx 및 PHP-FPM 설정
  2. 환경 변수 및 .env 파일
  3. GitHub Actions로 배포하기
  4. PHP 애플리케이션 Docker화
← PHP Academy(으)로 돌아가기