NelmioApiDocBundle 中 Symfony 7.2 的 "tagged" 类型弃用问题解析

在 Symfony 7.2 版本中，对依赖注入容器的配置方式进行了重要调整，其中一个显著变化是废弃了服务定义中 tagged 参数类型的使用。这一变化直接影响了 NelmioApiDocBundle 项目的服务配置。

NelmioApiDocBundle 是一个流行的 Symfony 扩展包，用于自动生成 API 文档。在最新版本中，该包的服务配置文件中仍在使用已被废弃的 tagged 参数类型，这会导致在使用 Symfony 7.2 及以上版本时出现弃用警告。

问题的核心在于服务容器配置文件中使用了类似这样的定义：

<argument type="tagged" tag="some_tag">

Symfony 7.2 推荐开发者改用 tagged_iterator 来替代原有的 tagged 类型。这种改变是 Symfony 框架持续优化其依赖注入系统的一部分，旨在提供更清晰、更一致的配置语法。

NelmioApiDocBundle 团队已经意识到这个问题，并在 4.33.6 版本中进行了修复。更新后的版本使用了新的 tagged_iterator 语法来配置服务参数，消除了与 Symfony 7.2 的兼容性问题。

对于使用 NelmioApiDocBundle 的开发者来说，建议采取以下措施：

1. 升级到 4.33.6 或更高版本
2. 检查项目中是否有自定义服务也使用了 tagged 类型
3. 逐步将项目中所有 tagged 用法迁移到 tagged_iterator

这种类型的框架变更虽然看似微小，但反映了 Symfony 框架对代码质量和长期维护性的重视。作为开发者，及时跟进这些变更可以确保应用的稳定性和未来兼容性。