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
매개변수를 사용하여 로컬로 설정된 환경 변수의 값을 반환합니다.
기타
- putenv() - 환경 변수의 값을 설정합니다.
- apache_getenv() - Apache subprocess_env 변수 가져오기
- Superglobals