array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.getenv.php', 1 => 'getenv', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'PHP オプション/情報 関数', ), 'prev' => array ( 0 => 'function.get-resources.php', 1 => 'get_resources', ), 'next' => array ( 0 => 'function.getlastmod.php', 1 => 'getlastmod', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/info/functions/getenv.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — 環境変数の値をひとつ、または全て取得する
環境変数の値をひとつ、または全て取得します。
phpinfo() を使えば、すべての環境変数の一覧を見ることができます。 これらの変数の多くは、 » RFC 3875 の section 4.1, "Request Meta-Variables" に挙げられているものです。
バージョン | 説明 |
---|---|
8.0.0 |
name は、nullable になりました。
|
7.1.0 |
name は、すべての環境変数の連想配列を取得するために
省略することができるようになりました。
|
7.0.9 |
local_only パラメーターが追加されました。
|
例1 getenv() の例
<?php
// getenv() の使用例
$ip = getenv('REMOTE_ADDR');
// または単純にスーパーグローバル($_SERVER または $_ENV)を使用します
$ip = $_SERVER['REMOTE_ADDR'];
// SAPI により設定されたか、または putenv により変更されたかどうかを無視して
// 環境変数の値を安全に取得します。
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>
PHP が Fast CGI のような SAPI で実行中の場合、
同じ名前のローカル環境変数を設定するために putenv() が使用されても、
この関数は SAPI により設定された環境変数の値を常に返します。
ローカル設定された環境変数の値を返すには、
local_only
パラメーターを使用してください。