2026.05.16 | 조회 : 7
Ubuntu 환경에서 환경변수 저장 및 PHP getenv() 사용 방법 - 2
OpenAI API Key 같은 민감한 값을 PHP 코드에 직접 작성하지 않고 /etc/environment 와 PHP-FPM www.conf 에 저장하여 사용하는 방법을 정리합니다.
/etc/environment 에 환경변수 저장
CLI 환경이나 크론(cron) 환경에서도 동일하게 사용하려면 /etc/environment 파일에 환경변수를 저장하는 것이 좋습니다.
sudo nano /etc/environment
파일 내부에 아래와 같이 추가합니다.
YOUR_OPENAI_API_KEY=**************
/etc/environment 는 일반 쉘 스크립트가 아니므로 export 를 사용하지 않습니다.
환경변수 적용
저장 후 현재 세션에 환경변수를 적용합니다.
source /etc/environment
현재 쉘에도 즉시 반영하려면 아래 명령어를 실행합니다.
export $(grep -v '^#' /etc/environment | xargs)
이후 CLI 에서 getenv() 로 접근 가능합니다.
PHP-FPM www.conf 에 환경변수 저장
웹 서버(Nginx + PHP-FPM) 환경에서는 PHP-FPM 프로세스가 별도로 동작하기 때문에 www.conf 에도 환경변수를 등록하는 것이 안전합니다.
sudo nano /etc/php/5.6/fpm/pool.d/www.conf
아래 내용을 추가합니다.
env[YOUR_OPENAI_API_KEY]="**************"
PHP-FPM 설정에서는 문자열 안전성을 위해 따옴표 사용을 권장합니다.
PHP-FPM 재시작
설정 저장 후 PHP-FPM 을 재시작해야 적용됩니다.
sudo systemctl restart php5.6-fpm
PHP getenv() 사용 방법
PHP 코드에서는 getenv() 함수로 환경변수를 가져올 수 있습니다.
$envName = 'YOUR_OPENAI_API_KEY';
$apiKey = getenv($envName);
if(!$apiKey){
log_message('error', $envName.' 없음');
return false;
}
이렇게 구성하면 운영 서버, 테스트 서버, 로컬 환경에서 코드 수정 없이 환경변수 값만 다르게 설정하여 사용할 수 있습니다.
환경변수 정상 동작 확인
CLI 에서 아래 명령어로 정상 적용 여부를 확인할 수 있습니다.
php -r "var_dump(getenv('YOUR_OPENAI_API_KEY'));"
