当前位置：首页 > 文章列表 > 文章 > php教程 > PHP解析.env为数组的正确方法

PHP解析.env为数组的正确方法

2026-01-18 15:09:59 0浏览收藏

目前golang学习网上已经有很多关于文章的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《PHP 安全解析 .env 文件为数组方法》，也希望能帮助到大家，如果阅读完后真的对你学习文章有帮助，欢迎动动手指，评论留言并分享~

如何在 PHP 中安全解析 .env 格式（X=Y）配置文件为关联数组

本文介绍一种健壮、兼容性强的 PHP 方法，用于读取无节区（section-less）的 `.env` 配置文件（如 `KEY=VALUE` 格式），正确处理含多个等号的值（如 base64 密钥），并返回标准关联数组。

在 PHP 开发中，.env 文件虽非原生 INI 标准（缺少 [section] 头部），但其 KEY=VALUE 的键值对格式广泛用于环境配置（如 Laravel、Symfony）。直接使用 parse_ini_file() 会失败——因其严格要求 INI 结构；而 include() 则存在严重安全风险（执行任意 PHP 代码），绝不可用于未受信配置文件。

以下是一个生产就绪的解析方案，核心思路是：逐行读取 → 跳过空行与注释 → 按首个 = 分割键与值 → 自动处理多等号场景（如 APP_KEY=base64:xxx=yyy=zzz）：

function loadDotEnv($filepath): array
{
    if (!is_readable($filepath)) {
        throw new InvalidArgumentException("Cannot read .env file: {$filepath}");
    }

    $data = [];
    $lines = file($filepath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

    foreach ($lines as $line) {
        // 跳过注释行（以 # 或 ; 开头）
        $line = trim($line);
        if (empty($line) || $line[0] === '#' || $line[0] === ';') {
            continue;
        }

        // 定位第一个等号位置，确保值中可含多个 '='（如 base64 密钥）
        $pos = strpos($line, '=');
        if ($pos === false) {
            continue; // 忽略无等号的无效行
        }

        $key   = trim(substr($line, 0, $pos));
        $value = trim(substr($line, $pos + 1));

        // 移除值两端的引号（支持单引号/双引号，常见于 .env 规范）
        if (($value[0] === '"' && substr($value, -1) === '"') ||
            ($value[0] === "'" && substr($value, -1) === "'")) {
            $value = substr($value, 1, -1);
        }

        $data[$key] = $value;
    }

    return $data;
}

// 使用示例
try {
    $env = loadDotEnv(__DIR__ . '/../../.env');
    echo "Loaded " . count($env) . " environment variables.\n";
    // 如：var_dump($env['APP_NAME']); // 'Laravel'
} catch (Exception $e) {
    error_log('Failed to load .env: ' . $e->getMessage());
}

✅ 关键特性说明：