Symfony 环境检测在 FrankenPHP 识别错误修复-php教程-PHP中文网

symfony在frankenphp下误判环境的根本原因是其不自动加载.env且依赖caddy的php_env指令透传变量，若未在handle块内正确配置或docker未声明app_env与app_debug双变量，symfony将回退至prod。

symfony 环境检测在 frankenphp 识别错误修复

FrankenPHP 下 Symfony 环境检测常把 dev 误判为 prod，根本原因不是 Symfony 配置错，而是 FrankenPHP 的 $_SERVER['APP_ENV'] 未被正确注入或被 Caddy 层覆盖。它默认不透传环境变量，也不自动读取 .env —— 这和 PHP-FPM 的 env[APP_ENV] 或 Apache 的 SetEnv 行为完全不同。

为什么 `bin/console about` 显示 `APP_ENV=prod` 却实际在 dev 模式跑？

典型现象是：本地改了控制器、清了缓存，页面没更新；var/log/dev.log 里没日志；debug:container 报错说服务未定义。这说明 Symfony 启动时加载的是 config/packages/prod/ 下的配置，而非 dev/。

根本原因在于 FrankenPHP 启动时不会自动加载 .env 文件，也不会把 shell 环境里的 APP_ENV 注入到 PHP 进程中 —— 它只认自己启动命令里显式传入的环境变量，或者 Caddyfile 中通过 php_env 指令设置的值。

直接运行 frankenphp php-server 时，$_SERVER['APP_ENV'] 是空的，Symfony 回退到默认值 prod
用 Docker 启动时，如果没在 docker run 或 compose.yaml 里加 -e APP_ENV=dev，结果一样
Caddyfile 里漏写 php_env APP_ENV dev，即使 .env 存在也无效

`php_env` 必须写在 Caddyfile 的 `php` 路由块内

FrankenPHP 的环境变量传递依赖 Caddy 的 php_env 指令，但它**不能放在全局或 handle 外层**，否则不生效。必须嵌套在处理 PHP 请求的路由逻辑里。

错误写法（变量不传递）：

btpanel phpsite 宝塔面板PHP网站

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

下载

localhost {
    php_env APP_ENV dev
    root * /app/public
    php
    file_server
}

正确写法（生效）：

localhost {
    root * /app/public
    handle *.php {
        php_env APP_ENV dev
        php
    }
    file_server
}

php_env 只对当前 handle 块内的 php 执行生效
若项目用 index.php 入口，确保 handle 匹配路径能覆盖它（如 handle /index.php 或 handle *.php）
多个环境要区分时，可结合 import 或条件判断，但别试图用 if 动态设 php_env —— 不支持

Docker 部署时 `APP_ENV` 和 `APP_DEBUG` 必须双设

在容器里光靠 Caddyfile 不够，因为 FrankenPHP 启动前就需确定环境。Docker 场景下，APP_ENV 和 APP_DEBUG 必须同时声明，否则 Symfony 会因 APP_DEBUG 缺失而强制降级为 prod。

在 compose.yaml 的 environment 下明确写：

environment:
  - APP_ENV=dev
  - APP_DEBUG=1

如果用 docker run，必须带两个 -e：

docker run -e APP_ENV=dev -e APP_DEBUG=1 dunglas/frankenphp

注意：Docker 的 ENV 指令在 Dockerfile 里设无效，因为 FrankenPHP 的入口脚本不读它；必须用运行时 -e 或 environment

验证是否真正生效的三个命令

别只信 bin/console about，它可能缓存了旧值。以下才是真实检测点：

执行 frankenphp php-cli -r "echo \$_SERVER['APP_ENV'] ?? 'MISSING';" —— 输出必须是 dev，不是空或 prod
访问 /_profiler，看左下角是否显示 Environment: dev；若显示 prod，说明前端路由或缓存层干扰了
临时在 public/index.php 顶部加 die($_SERVER['APP_ENV'] ?? 'no env');，直连服务器确认原始值