萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP $_ENV 超全域變數詳解:環境變數讀取、部署配置與安全最佳實踐

什麼是 $_ENV?

$_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
}
?>

環境變數來源優先序

  1. 系統級:/etc/environment, /etc/profile, Shell RC 檔
  2. Web 伺服器:Apache SetEnv, PassEnv;Nginx fastcgi_param
  3. PHP-FPM 池配置:env[VAR] = value 在 www.conf
  4. Docker:docker run -e VAR=value, docker-compose.yml environment:
  5. Kubernetes:ConfigMap/Secret 掛載為環境變數
  6. .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 檔案範例(絕不可提交版控)

# .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

安全最佳實踐

  1. 敏感資訊只走環境變數:資料庫密碼、API Key、JWT Secret 絕不寫在代碼
  2. 生產環境禁用 phpinfo():洩露所有環境變數
  3. 最小權限原則:容器/VM 僅注入該服務所需變數
  4. 定期輪換密鑰:配合 CI/CD 自動部署新密鑰
  5. 區分環境:開發/測試/生產使用不同 .env,APP_ENV 區分

常見坑點

問題原因解決
$_ENV 為空PHP 設定 variables_order 不含 Ephp.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

現代框架整合

  • Laravel:config() helper 讀取 config/*.php,底層用 env() 讀 $_ENV
  • Symfony:$_ENV 自動對應 %env(VAR)% 參數
  • Slim/Mezon/原生:自行實作上述 Config 類或用 symfony/config
copyright © 萬盛學電腦網 all rights reserved