getenv

(PHP 4, PHP 5, PHP 7, PHP 8)

getenv — 환경 변수의 값을 가져옵니다.


설명

getenv(string $varname, bool $local_only = false): string|false

getenv(): array

환경 변수의 값을 가져옵니다.

phpinfo()를 사용하여 모든 환경 변수의 목록을 볼 수 있습니다. 이러한 변수의 대부분은 » RFC 3875, 특히 섹션 4.1, '메타 변수 요청'에 나열되어 있습니다.


매개변수

varname
변수 이름입니다.
local_only
로컬 환경 변수(운영 체제 또는 putenv에서 설정)만 반환하려면 true로 설정합니다.

반환 값

환경 변수 varname의 값을 반환하거나 환경 변수 varname이 없으면 false를 반환합니다. varname을 생략하면 모든 환경 변수가 연관 배열로 반환됩니다.


변경 로그

버전 설명
7.1.0 이제 varname을 생략하여 모든 환경 변수의 연관 배열을 검색할 수 있습니다.
7.0.9 local_only 매개변수가 추가되었습니다.

Examples

예제 #1 getenv() 예제

                  
<?php
// Example use of getenv()
$ip = getenv('REMOTE_ADDR');

// Or simply use a Superglobal ($_SERVER or $_ENV)
$ip = $_SERVER['REMOTE_ADDR'];

// Safely get the value of an environment variable, ignoring whether
// or not it was set by a SAPI or has been changed with putenv
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>
                  
                

노트

경고 PHP가 Fast CGI와 같은 SAPI에서 실행 중인 경우 이 함수는 동일한 이름의 로컬 환경 변수를 설정하는 데 putenv()가 사용된 경우에도 항상 SAPI에 의해 설정된 환경 변수 값을 반환합니다. local_only 매개변수를 사용하여 로컬로 설정된 환경 변수의 값을 반환합니다.


기타