symfony没有内置when配置关键字，它仅在routes.yaml的condition属性中合法有效；真正支持的条件化配置方式是环境目录隔离、参数占位符（如%env(app_env)%）和php配置文件。
Symfony 没有叫 when 的内置配置关键字 —— 它不是 YAML 配置项，也不是框架原生支持的条件语法。你在 config/packages/ 或 config/packages/framework.yaml 里直接写 when:，YAML 解析会报错，或者被忽略。
为什么有人误以为 Symfony 支持 when 配置
常见混淆来源有三个：
- 把 Symfony 的
when路由条件表达式（用于routing.yaml）当成全局配置语法 - 看到某些第三方 Bundle 文档里自定义了
when:键（如liip_imagine的缓存策略），误以为是 Symfony 核心能力 - 把 PHP 的
if逻辑或环境变量判断（如%env(bool:APP_DEBUG)%）脑补成 YAML 层面的条件块
when 只在路由定义中合法且有效
它只出现在 config/routes.yaml 或注解路由的 condition 属性里，作用是：根据请求属性、服务器变量或表达式决定是否匹配该路由。
示例（config/routes.yaml）：
admin_homepage:
path: /admin
controller: App\Controller\AdminController::index
condition: "request.attributes.get('route') == 'admin_homepage' and request.getMethod() == 'GET'"
注意点：
-
condition值必须是字符串，里面写的是 Symfony 表达式语言（ExpressionLanguage）语法，不是 PHP - 不能访问任意 PHP 函数，仅限白名单（
request,app,context,service()等） - 性能敏感：每个请求都会执行该表达式，避免复杂计算或数据库查询
- 调试困难：表达式失败时通常静默不匹配，建议配合
php bin/console debug:router验证
想实现“配置按环境/条件生效”，该用什么
Symfony 真正支持的条件化配置方式只有三种：
-
环境隔离：靠目录结构，如
config/packages/dev/下的 YAML 只在APP_ENV=dev时加载 -
参数占位符：用
%env(APP_ENV)%或%env(bool:FEATURE_FLAG)%在值层面做开关，例如：cache_adapter: '%env(CACHE_ADAPTER)%' -
PHP 配置文件：把
framework.yaml替换为framework.php，用 PHP 写 if/else 逻辑（适合复杂分支，但失去 YAML 的可读性）
比如你想在 prod 环境禁用某服务，不要写 when: env(prod)，而是把它放进 config/packages/prod/cache.yaml 并设 enabled: false。
容易踩的坑：别在 YAML 里硬塞条件逻辑
以下写法全部无效或危险：
-
when: '%env(APP_ENV)% == "prod"'→ YAML 不解析这个，直接当字符串键名 -
if: ...或condition:写在services.yaml顶层 → 解析失败，容器构建中断 - 试图用 Twig 语法
{% if %}混入 YAML 文件 → YAML 解析器直接报错 - 在
framework.yaml里写when: { env: prod }→ 框架不认识，忽略或抛异常
真正起作用的永远是「文件位置 + 参数注入 + 表达式语言（仅限路由）」三层组合。想让配置“活”起来，得从这三处下手，而不是找一个不存在的 when 开关。
