FrankenPHP 1.2 不解析 .env 文件，需在入口文件顶部显式调用 Dotenv::createImmutable()->load()，且确保 .env 位置正确、格式合规、putenv() 可用、无构建固化或 OPcache 缓存干扰。
FrankenPHP 1.2 读取 .env 失效，根本原因很明确：它本身不解析 .env 文件，也不自动加载任何环境变量文件。是否生效，完全取决于你的 PHP 入口代码有没有正确、及时地调用 Dotenv 加载逻辑——和 Laravel、Symfony 或 ThinkPHP 的机制一致，不是服务器该干的事。
确认 .env 是否被显式加载
FrankenPHP 启动后只是运行 PHP 脚本，不会主动扫描或读取 .env。你必须在入口文件（如 public/index.php）最顶部手动初始化：
- 检查是否存在类似以下代码（路径需匹配项目结构）：
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__.'/..');<br>$dotenv->load();
- 确保这段代码在
require_once __DIR__.'/../vendor/autoload.php';之前执行，否则框架可能已提前读取空的$_ENV - 若使用 ThinkPHP，确认
public/index.php中有Env::load()调用；若用 Symfony，检查public/index.php是否包含Dotenv::create(...)->load()
检查 .env 文件是否可访问且格式合规
即使代码写了 load()，如果文件不可见或内容异常，也会静默失败：
-
.env必须放在项目根目录（与composer.json或thinkphp目录同级），不能放在public/下 - 每行严格为
KEY=VALUE，等号两侧不能有空格，不支持引号包裹、注释嵌套或变量引用（如$APP_ENV） - 文件编码必须是 UTF-8 无 BOM，换行符为 LF（Linux 风格）；可用
file -i .env和head -n1 .env | cat -A检查 - Docker 环境下，确认
.env已通过volumes显式挂载：volumes:<br> - ./.env:/app/.env
验证 putenv() 是否可用及环境变量是否注入运行时
phpdotenv 依赖 putenv() 将变量写入 PHP 运行时环境。若该函数被禁用，.env 就形同虚设：
立即学习“PHP免费学习笔记（深入）”；
- 执行
php -r "var_dump(function_exists('putenv'));"，输出bool(false)即表示禁用（常见于 Alpine 镜像） - 若禁用，
getenv('DB_HOST')和$_ENV['DB_HOST']均为空；此时应改用容器启动时透传：docker run -e DB_HOST=localhost -e APP_DEBUG=1 frankenphp-app - 也可在 Caddyfile 中用
{env.DB_HOST}并配合CADDY_ENV=...启动 FrankenPHP，绕过putenv()
排除缓存与构建固化干扰（尤其静态二进制场景）
FrankenPHP 1.2 独立二进制（如官方下载版）在构建时就固化了 PHP 配置和部分环境感知逻辑，运行时不会重新读 .env：
- 执行
phpinfo()查看 Loaded Configuration File，若显示embedded://php.ini，说明所有 ini 设置来自编译嵌入，php.ini文件放哪都不生效 - 若使用
frankenphp build打包，.env内容只在构建阶段被读取一次（例如用于生成配置缓存），后续修改.env必须重新构建二进制 - OPcache 开启且未设
opcache.validate_timestamps=1时，修改.env后旧变量仍可能被缓存，可临时加--php-flags "-d opcache.enable=0"启动验证
