Symfony自动注入环境变量：如何设默认值避免CI报错？

问题背景 #

之前在services.yaml中通过绑定参数的方式注入环境变量，需要编写大量样板代码：

parameters:
  env(PUBLISH_CHECK_CYCLE_SECONDS): '3600'

services:
  _defaults:
    bind:
      $publishCheckCycleSeconds: '%env(int:PUBLISH_CHECK_CYCLE_SECONDS)%'

  SomeService: ~ # for binds

尝试改用#[Autowire]注解直接在构造函数中注入，虽然简化了配置，但当环境变量不存在时（如CI环境）会报错：

class SomeService {
    public function __construct(
        #[Autowire(env: 'bool:CACHE_EXPANDED_REFERENCES')]
        private readonly bool $cacheExpandedEntities = true,
        #[Autowire(env: 'int:CACHE_EXPANDED_REFERENCES_SECONDS')]
        private readonly int $expandedReferencesCacheTime = 60 * 60 * 24,
    ) {}
}

报错信息：

In EnvVarProcessor.php line 217:
Environment variable not found: "CACHE_EXPANDED_REFERENCES".

尝试使用default处理器时写法错误，导致提示变量未定义：

#[Autowire(env: 'default:true:bool:CACHE_EXPANDED_REFERENCES')]

报错信息：

In EnvVarProcessor.php line 124:
Invalid env fallback in "default:true:bool:CACHE_EXPANDED_REFERENCES": parameter "true" not found

最佳解决方案 #

使用default环境变量处理器结合literal:前缀，直接指定字面量默认值，无需额外配置参数或环境变量：

布尔类型示例 #

#[Autowire(env: 'default:literal(true):bool:CACHE_EXPANDED_REFERENCES')]
private readonly bool $cacheExpandedEntities = true,

整数类型示例 #

#[Autowire(env: 'default:literal(86400):int:CACHE_EXPANDED_REFERENCES_SECONDS')]
private readonly int $expandedReferencesCacheTime = 86400,

原理说明 #

• default: 处理器用于指定环境变量不存在时的 fallback 值
• literal: 前缀告诉Symfony后续内容是字面量值，而非参数或其他环境变量，避免被当作参数名解析
• 后续的bool:/int:是类型转换处理器，将环境变量值转换为对应类型

这种写法完全避免了services.yaml中的样板代码，同时确保环境变量缺失时自动使用默认值，符合需求。

注意：literal: 前缀的支持从Symfony 5.4和6.0版本开始提供，如果使用更早版本，需要通过定义参数作为默认值（但会增加少量样板代码）。

内容的提问来源于stack exchange，提问作者radonthetyrant