宝塔面板中PHP 8.4环境变量需通过PHP-FPM配置、网站单独设置或系统级扩展三种方式注入；验证需在对应站点执行env_check.php脚本确认getenv()或$_SERVER能否读取。
如果您在宝塔面板中运行PHP 8.4项目时，需要向PHP脚本注入自定义环境变量（如API密钥、数据库配置等），但发现getenv()或$_SERVER无法读取，可能是变量未正确注入到PHP-FPM进程上下文中。以下是针对PHP 8.4版本在宝塔面板中配置自定义环境变量的多种操作方法：
一、通过PHP-FPM配置文件直接添加env变量
该方法将变量注入到PHP-FPM子进程中，对所有使用该PHP版本的网站生效，作用范围为FPM池级别，适用于全局共享变量。
1、登录宝塔面板，访问http://服务器IP:8888，输入账号密码进入控制台。
2、在左侧菜单点击【软件商店】，在「已安装」列表中找到PHP 8.4，点击右侧「设置」按钮。
立即学习“PHP免费学习笔记（深入）”；
3、切换至【配置修改】选项卡，在打开的配置文件中定位到[www]区块（若为其他池名如[www-84]，请确认匹配）。
4、在[www]区块内新增一行，格式为env[变量名]="变量值"，例如：
env[APP_ENV]="production"
env[REDIS_HOST]="127.0.0.1"
5、保存配置文件，返回PHP管理界面，点击右上角「重启」按钮使PHP-FPM重载新配置。
二、通过网站单独配置环境变量（站点级）
该方法仅对指定网站生效，变量存储于宝塔加密环境变量系统中，安全性更高，适合存放敏感信息，且支持作用域分级控制。
1、在宝塔面板左侧点击【网站】，找到目标站点，点击其右侧「设置」按钮。
2、在网站设置页面左侧菜单中，点击【PHP】选项。
3、向下滚动至「环境变量」区域，点击「变量设置」按钮。
4、点击「添加变量」，依次填写：
变量名：JWT_SECRET
变量值：aBcD1234EfGh5678IjKl9012
作用范围：站点
5、点击「添加」保存，随后返回网站设置首页，点击右上角「重启PHP」或「重载服务」以刷新上下文。
三、通过Linux系统级环境变量扩展（CLI与FPM双支持）
该方法确保PHP命令行（CLI）和Web请求（FPM）均能读取同一套变量，适用于需统一环境的部署场景，但需手动编辑系统配置文件。
1、使用SSH登录服务器，执行以下命令编辑全局profile文件：
echo 'export PHP84_APP_DEBUG=true' >> /etc/profile
echo 'export PATH=/www/server/php/84/bin:$PATH' >> /etc/profile
2、使配置立即生效：
source /etc/profile
3、编辑PHP 8.4的FPM服务文件（路径通常为/www/server/php/84/etc/php-fpm.d/www.conf），在[www]区块末尾追加：
env[PHP84_APP_DEBUG]="$PHP84_APP_DEBUG"
4、重启PHP-FPM服务：
systemctl restart php-fpm-84
四、验证环境变量是否生效
该步骤用于确认前述任一方法配置后的实际效果，必须在对应PHP版本及站点上下文中执行，避免误判。
1、在网站根目录（如/www/wwwroot/example.com）新建文件env_check.php。
2、写入以下内容并保存：
3、通过浏览器访问https://example.com/env_check.php。
4、检查输出结果中各变量值是否与配置一致，若显示bool(false)或string(0) ""，说明对应变量未加载成功。
