PhpStorm运行项目怎么加载特定的.env文件_配置环境变量启动执行【技巧】-phpstorm-PHP中文网

phpstorm本身不读取.env文件，getenv()返回空属正常；需手动加载vlucas/phpdotenv库或在run配置中显式设置环境变量才能生效。

phpstorm运行项目怎么加载特定的.env文件_配置环境变量启动执行【技巧】

PhpStorm 本身不读 .env 文件，运行 PHP 脚本时 getenv() 返回空是正常的——除非你手动加载了 dotenv 库，或在运行配置里显式注入变量。

为什么右键 Run PHP 文件却读不到 `.env` 里的值

因为 PhpStorm 的「Run」操作默认只调用系统 PHP 解释器执行脚本，不自动解析项目根目录下的 .env 文件。它既不调用 vlucas/phpdotenv，也不走 symfony/dotenv 的加载逻辑。哪怕你把 .env 放在项目最顶层，echo getenv('APP_ENV') 依然输出空字符串。

PHP 原生不支持 .env ——$_ENV 和 getenv() 只读操作系统级环境变量，不是文本文件
WebStorm/PhpStorm 的 EnvFile 插件仅影响 IDE 内部补全、HTTP Client 和调试器变量显示，不改变实际 PHP 进程的 $_ENV
Terminal 窗口完全不继承项目级环境配置，php -r "var_dump(getenv('APP_ENV'))" 必然为 false

让 `getenv()` 在 PhpStorm 运行时生效的两种可靠方式

选一种，别混用。否则容易出现变量重复、覆盖或加载时机错误。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

方式一：用 vlucas/phpdotenv（推荐）
在入口文件顶部（index.php 或 public/index.php）加三行：

$dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/..');
$dotenv->load();
// 后续代码才能安全使用 getenv('DB_HOST')

方式二：在 Run 配置里手动填环境变量
打开 Edit Configurations → Environment variables，直接写：APP_ENV=local;DB_HOST=localhost
注意：; 是分隔符（Windows/macOS/Linux 统一用分号），不是冒号

多环境 `.env` 文件怎么切换（比如 `.env.local` / `.env.prod`）

别指望 PhpStorm 自动识别多个文件名。vlucas/phpdotenv 默认只加载 .env，要支持其他名字，得显式传参：

加载 .env.local：Dotenv::createImmutable(__DIR__, '.env.local')->load()
按优先级链式加载（开发时覆盖生产）：Dotenv::createImmutable(__DIR__, ['.env', '.env.local'])->load()
如果用 symfony/dotenv，语法类似：(new Dotenv())->usePutenv()->load(__DIR__.'/../.env.local');
切记：这些路径必须相对于 createImmutable() 的第一个参数，不是相对于当前脚本