$_ENV 是 PHP 的超全域陣列,包含執行環境的環境變數。PHP 啟動時,從作業系統 Shell、Web 伺服器(Apache/Nginx/FPM)、容器環境(Docker/K8s)繼承環境變數,自動填入此陣列。
<?php
// 讀取單一變數
echo 'User: ' . ($_ENV['USER'] ?? 'unknown');
echo 'Home: ' . ($_ENV['HOME'] ?? '/none');
// 遍歷所有(除錯用)
echo '<pre>';
print_r($_ENV);
echo '</pre>';
// 檢查是否存在
if (isset($_ENV['APP_ENV'])) {
$env = $_ENV['APP_ENV']; // production, staging, development
}
?>
/etc/environment, /etc/profile, Shell RC 檔SetEnv, PassEnv;Nginx fastcgi_paramenv[VAR] = value 在 www.confdocker run -e VAR=value, docker-compose.yml environment:.env 檔案:透過 vlucas/phpdotenv 載入(不自動進入 $_ENV,需手動 $dotenv->load())<?php
// config/bootstrap.php
require_once __DIR__ . '/vendor/autoload.php';
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load(); // 將 .env 載入 $_ENV 和 $_SERVER
$dotenv->required(['APP_KEY', 'DB_PASSWORD'])->notEmpty();
// 統一配置存取層
class Config {
public static function get(string $key, $default = null) {
// 優先序:$_ENV > $_SERVER > getenv() > 預設值
return $_ENV[$key]
?? $_SERVER[$key]
?? getenv($key)
?? $default;
}
public static function bool(string $key): bool {
$val = strtolower(self::get($key, 'false'));
return in_array($val, ['1', 'true', 'yes', 'on'], true);
}
public static function int(string $key): int {
return (int)self::get($key, 0);
}
}
// 使用
$dbHost = Config::get('DB_HOST', '127.0.0.1');
$debug = Config::bool('APP_DEBUG');
$port = Config::int('DB_PORT');
?>
# .env.example (提交版控作為範本)
APP_ENV=production
APP_DEBUG=false
APP_KEY=
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=app_user
DB_PASSWORD=changeme
REDIS_HOST=127.0.0.1
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
phpinfo():洩露所有環境變數APP_ENV 區分| 問題 | 原因 | 解決 |
|---|---|---|
$_ENV 為空 | PHP 設定 variables_order 不含 E | php.ini: variables_order = "EGPCS" (E=ENV) |
getenv() 有值但 $_ENV 沒有 | PHP-FPM clear_env = yes 清理了環境 | 池配置 clear_env = no 或用 getenv() |
| Docker 變數未傳入 | 未在 docker run -e 或 compose 宣告 | 檢查 docker inspect Config.Env |
| 修改 .env 不生效 | PHP-FPM 已載入舊進程環境 | 重啟 PHP-FPM: systemctl reload php-fpm |
config() helper 讀取 config/*.php,底層用 env() 讀 $_ENV$_ENV 自動對應 %env(VAR)% 參數Config 類或用 symfony/config