symfony 2.3.40 中 compiler pass 是编译前动态修改服务定义的机制，需手动注册、支持按标签批量处理、调整作用域，并须避免在未就绪容器中调用 get() 或误改未声明服务。
在 Symfony 2.3.40 中，编译器 Pass（Compiler Pass）是修改服务定义的底层机制，适用于需在容器编译完成前动态调整服务行为的场景，比如为旧应用服务注入工厂参数、批量标记日志 handler、或统一添加装饰器。它不依赖配置文件自动加载，需手动注册并实现逻辑。
注册自定义 Compiler Pass
必须将 Pass 类添加到容器编译流程中，通常在 Bundle 的 build() 方法里注册：
- 新建类 src/YourBundle/DependencyInjection/Compiler/InjectOldAppFactoryPass.php，实现 CompilerPassInterface
- 在 YourBundle.php 的 build() 方法中调用：
$container->addCompilerPass(new InjectOldAppFactoryPass()); - 确保该 Bundle 已在 AppKernel.php 中启用
按标签批量处理服务定义
Compiler Pass 的典型用途是识别带特定标签的服务，并统一修改其工厂或参数。例如，为所有标记 old_app.service 的服务自动设置工厂调用：
- 在 services.yml 中为旧服务打标签：
tags: [{ name: old_app.service }] - 在 Pass 的 process() 方法中遍历定义：
使用$container->findTaggedServiceIds('old_app.service')获取 ID 列表 - 对每个服务定义调用
$definition->setFactory(array($factoryServiceId, 'factory'))，并用addArgument()注入 FQCN 字符串
修改服务作用域与可见性
Symfony 2.3.40 默认服务为私有（public: false），若测试中需临时公开某些服务，可在 Pass 中强制设为公有：
- 检查定义是否匹配目标类名或标签，如
$definition->getClass() === 'App\Legacy\PaymentGateway' - 调用
$definition->setPublic(true)，使其可通过$container->get()直接访问 - 注意：仅建议用于测试相关服务，生产环境应保持私有以保障封装性
避免常见陷阱
Compiler Pass 运行时容器尚未完全构建，部分服务可能还未定义，操作需谨慎：
- 不要在 Pass 中调用
$container->get()—— 此时服务实例尚未创建 - 勿直接修改未被标记或未声明的服务，否则易引发依赖解析失败
- 若需依赖其他服务（如工厂类），应在
process()前通过$container->hasDefinition()确认存在 - 调试时可用
var_dump($definition->getFactory())查看当前配置，但上线前务必移除
