FrankenPHP运行Symfony时.env变量不生效，根本原因是其直接执行public/index.php，跳过了Composer自动注册的Dotenv初始化流程；需在index.php中手动插入(new Dotenv())->usePutenv(true)->loadEnv(__DIR__.'/../.env')并设override=true以强制覆盖系统变量，且修改后必须重启FrankenPHP进程。
FrankenPHP 运行 Symfony 时 .env 文件里的变量（比如 APP_ENV=prod）不生效，根本原因不是文件没读到，而是 FrankenPHP 默认不触发 Symfony 的 Dotenv 加载逻辑 —— 它直接调用 PHP 脚本入口（如 public/index.php），跳过了 Composer 自动加载器中默认注册的 Dotenv::createUnsafeImmutable() 初始化流程。
为什么 Symfony 的 .env 在 FrankenPHP 下被忽略
Symfony 标准启动流程依赖 vendor/autoload_runtime.php 中的 runtime hook：它会在 require_once 'vendor/autoload.php' 前，自动加载并解析 .env。但 FrankenPHP 启动时是直接执行 public/index.php，而这个文件开头就是 use Symfony\Component\Runtime\Runner\SymfonyRuntime; 等语句，并未显式引入 runtime loader。结果就是 $_ENV 和 getenv() 里只有系统级环境变量，.env 内容完全没进内存。
常见现象包括：
-
APP_DEBUG=0不生效 → 错误页面仍显示完整堆栈 -
DATABASE_URL为空 → 连接数据库时报Connection refused -
MAILER_DSN未读取 → 邮件发送直接失败，无报错提示
在 public/index.php 开头手动加载 Dotenv
最直接、兼容性最好的解法：修改 Symfony 项目的 public/index.php，在所有 use 语句之后、require 之前，插入 Dotenv 加载逻辑。
立即学习“PHP免费学习笔记（深入）”；
实操步骤：
- 确认项目已安装
symfony/dotenv（Laravel/Symfony 5.4+ 默认包含；若缺失，运行composer require symfony/dotenv） - 打开
public/index.php，在use块结束后的第一行插入：
use Symfony\Component\Dotenv\Dotenv; (new Dotenv())->usePutenv(true)->loadEnv(__DIR__.'/../.env');
-
usePutenv(true)是关键：它把变量写入putenv()，确保后续getenv()和$_ENV都能读到（FrankenPHP 的 PHP 运行时支持该行为） - 不要用
load()替代loadEnv()—— 后者会按环境后缀（如.env.local）自动合并，符合 Symfony 原有约定
避免使用 .env.local.php 缓存文件
Symfony 在 APP_ENV=prod 下会自动生成 .env.local.php 并跳过 Dotenv 解析，以提升性能。但 FrankenPHP 的常驻进程模型下，这个缓存文件一旦生成，后续环境变量变更（如改了 DATABASE_URL）将完全不生效 —— 因为 PHP 进程不会重启，缓存也不会自动刷新。
建议做法：
- 开发/测试环境：直接删掉
.env.local.php，靠Dotenv动态加载 - 生产环境：**禁用缓存生成**，在
public/index.php中Dotenv加载后加一行：
$_SERVER['SYMFONY_DOTENV_VARS'] = '';
- 这会阻止 Symfony Runtime 创建缓存文件，强制每次请求都解析
.env（FrankenPHP worker 模式下开销极小，可忽略） - 切勿依赖
php bin/console dotenv:dump生成缓存 —— 它和 FrankenPHP 的常驻内存模型天然冲突
环境变量优先级与 FrankenPHP 的特殊限制
FrankenPHP 本身通过 ENV 指令或 Docker environment: 设置的变量，会进入 PHP 的 $_ENV，但 Symfony 的 Dotenv 默认不覆盖已存在的环境变量（除非显式传 override: true）。这意味着：
- 如果 Docker 中设了
APP_ENV=dev，但.env里写的是APP_ENV=prod，最终生效的是 Docker 值 - 想让
.env强制覆盖系统变量，需改Dotenv调用为：(new Dotenv())->usePutenv(true)->loadEnv(__DIR__.'/../.env', null, true);（第三个参数true表示 override） - FrankenPHP 的
ENV配置项仅在 Caddyfile 或 Dockerenvironment中有效，不能在php.ini里用env[APP_ENV]设置 —— 它不读取 php-fpm 风格的 pool 配置
最易被忽略的一点：FrankenPHP 的 worker 模式下，public/index.php 只在进程启动时执行一次。任何对 .env 的修改，必须重启 FrankenPHP 进程（docker restart 或 systemctl restart frankenphp）才能生效 —— 这和传统 FPM 的“每次请求重读”完全不同。
