symfony 7 多环境配置依赖 app_env 环境变量在容器编译时固化加载路径，而非运行时切换；cli 需前置设置 app_env=prod，apache 用 setenv，nginx 通过 fastcgi_param 透传，.env 加载顺序为 .env → .env.local → .env.app_env，when@ 仅作用于编译阶段。
Symfony 7 的多环境配置不是靠“切换”实现的，而是靠 APP_ENV 环境变量在启动时决定加载哪一套配置——它不运行时动态切换，只在容器编译那一刻固化。
APP_ENV 怎么生效：从 CLI 到 Web 服务器的三类写法
环境变量必须在 PHP 进程启动前注入，否则 Kernel::getEnvironment() 读到的就是默认值（dev）。
- CLI 场景：必须前置设置，不能靠
.env覆盖 ——APP_ENV=prod php bin/console cache:clear才有效；php bin/console cache:clear --env=prod已被弃用，不推荐 - Apache：用
SetEnv（非SetEnvIf），且需确保mod_env已启用：SetEnv APP_ENV prod - Nginx + PHP-FPM：必须通过
fastcgi_param透传，不能只设env指令：fastcgi_param APP_ENV prod;，且该行需放在include fastcgi_params;之后
config/packages/ 目录下环境子目录的加载规则
Symfony 不是“按需加载”，而是把所有匹配环境的 YAML 文件合并后一次性编译容器。比如 APP_ENV=prod 会同时加载：
-
config/packages/*.yaml（通用） -
config/packages/prod/*.yaml（生产专属） -
config/packages/dev/*.yaml（不会加载！除非你手动when@dev）
注意：config/packages/prod/doctrine.yaml 中写的 url: '%env(DATABASE_URL)%'，如果 .env.prod 里没定义 DATABASE_URL，运行时才报错，不是编译时报错。
dotenv 加载顺序与覆盖优先级陷阱
Symfony\Component\Dotenv\Dotenv::loadEnv() 的行为是链式覆盖，顺序决定最终值：
- 先加载
.env（基础变量） - 再加载
.env.local（本地覆盖，.gitignore 推荐） - 最后尝试加载
.env.<code>APP_ENV（如.env.prod），但仅当文件存在时才加载
常见坑：.env.local 里写了 APP_ENV=dev，但部署时忘了删，结果生产服务器跑成了 dev 环境——因为 .env.local 总是加载，且优先级高于 .env.prod。
服务条件加载：when@ 语法的真实作用域
when@dev 不是“只在 dev 环境注册”，而是“只在 dev 环境的容器编译阶段解析该段配置”。一旦编译完成，它就固化进 Container 类里，不存在运行时判断。
- 正确用法：
when@prod下禁用调试工具、关闭 profiler、缩小日志级别 - 错误用法：试图用
when@test动态切换数据库 URL —— 测试环境应靠.env.test提供不同DATABASE_URL，而不是改配置逻辑 - 注意：自定义环境（如
staging）必须显式声明，否则when@staging会被忽略
复杂点在于，环境变量和配置文件的加载发生在不同阶段：dotenv 在 bootstrap.php 就执行，而 YAML 配置合并是在 Kernel::registerContainerConfiguration() 里完成的——中间隔着整个 DI 容器初始化流程，变量缺失或拼写错误往往要到缓存重建时才暴露。
