phpstorm项目级环境变量仅在显式启用的运行/调试配置中生效，terminal不读取该配置，故getenv()返回false；其只作用于右键run、phpunit、phpcs等phpstorm显式调用的cli场景，不继承系统shell环境。

PhpStorm 的项目级环境变量只在显式启用的运行/调试配置中生效，Terminal 里 getenv() 返回 false 是正常现象，不是配置失败。

为什么 Terminal 里读不到你配的环境变量

PhpStorm 的 Terminal 工具窗口直接继承系统 shell 环境（比如 Windows 的 PATH 或 macOS 的 ~/.zshrc），完全不加载你在「Environments」里定义的变量。这些变量只对 PhpStorm 显式调用的执行场景起作用，比如：

• 右键 PHP 文件 → Run 'xxx.php'
• 执行一个已绑定环境的 PHPUnit 配置
• 运行 CLI Tools（如 PHPCS、PHPStan）时勾选了对应环境

验证是否生效最直接的方式：编辑对应运行配置 → 勾选 Show command line afterwards，看终端实际执行命令前是否拼上了类似 APP_ENV=local 这样的前缀。

怎样创建并启用一个项目专用的环境

别去 Settings 里找“全局环境变量”——那只是所有项目的默认值。项目隔离必须用「Environments」功能：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 项目视图中右键 Project → New → Environment，名称建议带项目缩写，如 myapp-dev
• 添加变量时，键名避免空格和特殊符号；Windows 路径用双反斜杠 C:\myapp\config 或正斜杠 C:/myapp/config
• 创建后不会自动启用，必须右键该环境 → Enable；禁用同理，右键 → Disable
• 多个环境可共存，但同一时间只能启用一个；切换后需重启当前运行配置才生效

运行/调试配置里怎么正确挂载环境

建好 myapp-prod 环境，不把它挂到具体配置上，它就是个摆设：

• 进入 Edit Configurations… → 找到你要用的 PHP Script / PHPUnit / CLI Tools 配置
• 切到 Environment 标签页，下拉框里选你刚启用的环境名（不是变量列表）
• 如果下拉为空，说明没启用过任何环境，或项目结构未刷新 → 尝试重启 PhpStorm，或右键项目根目录 → Reload project
• Include parent environment variables 默认不勾选更安全；勾选后会把系统 PATH、HOME 全塞进来，可能覆盖你精心配的 DB_HOST

Web 请求调试（Xdebug）不走这个环境配置

通过浏览器触发的 Web 请求（比如 http://localhost:8000/index.php）不会读取「Environments」里的变量。Xdebug 断点触发时，环境变量来自 Web 服务器本身：

• Apache：在 VirtualHost 或 .htaccess 里用 SetEnv APP_ENV local
• Nginx：在 server 块里加 fastcgi_param APP_ENV "local";
• PHP 内置服务器：无法直接传环境变量，需改代码，例如在入口文件开头加 putenv('APP_ENV=local');
• 或者统一用 $_SERVER 注入，在运行配置的 Server 设置里填好路径映射后，靠 Web 服务层传递

最容易被忽略的是：Web 和 CLI 是两套环境变量来源，混用会导致 getenv('APP_ENV') 在 CLI 脚本里有值、在 Web 请求里却为 false，排查前先确认调用上下文。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！