Symfony 编译器传递本质是在容器编译完成前用PHP代码动态修改服务定义，需实现CompilerPassInterface并重写process方法，在Bundle的build()中注册，仅操作定义、禁止获取实例。
写 Symfony 编译器传递（Compiler Pass）本质是在容器编译完成前，用代码动态修改服务定义。它不依赖 YAML 配置，而是通过 PHP 类在构建阶段介入，适合自动化注册、参数注入、标签处理等场景。
明确实现接口和注册位置
所有编译器传递必须实现 CompilerPassInterface，核心是重写 process(ContainerBuilder $container) 方法。它不能直接在配置文件里启用，必须在 Bundle 的 build() 方法中显式添加：
- 在 Bundle 类（如
MyBundle.php）中重写build() - 调用
$container->addCompilerPass(new MyCustomPass()) - 确保该 Bundle 已在
Kernel::registerBundles()中启用
典型操作：修改服务参数或引用
常见需求是给某个服务动态设参数，比如把类名字符串传给工厂方法，或替换某个依赖为 null。关键用法包括：
-
$container->getDefinition('service.id')获取服务定义对象 -
$definition->replaceArgument(0, new Reference('another.service'))替换第 0 个参数为服务引用 -
$definition->replaceArgument(2, 'App\Entity\User')替换为字符串字面量 -
$definition->setArgument('$debug', true)按构造参数名设置（需 PHP 8.0+ 或命名参数支持）
安全检查：避免运行时错误
编译器传递执行时，容器尚未完全就绪，很多服务可能还没定义。务必做存在性判断：
- 用
$container->hasDefinition('service.id')判断服务是否存在 - 用
$container->hasParameter('param.name')判断参数是否已设 - 避免调用
$container->get()—— 此时服务实例还未创建，会报错 - 不要在
process()中触发任何实际业务逻辑，只做定义级变更
结合服务标签批量处理
当需要统一处理一批服务（如所有 translation.loader），可先遍历带指定标签的服务：
$taggedServices = $container->findTaggedServiceIds('translation.loader')- 遍历返回的
['id' => [ [...], [...] ]]数组 - 对每个
$id调用$container->getDefinition($id)修改其定义 - 这种模式被 TranslatorPass、RegisterMappingsPass 等广泛使用
不需要复杂工具链，一个接口 + 一个类 + 一次注册，就能让容器在启动前自动完成原本要手动写的几十行 YAML 配置。
