DoctrineExtensions 项目中关于软删除依赖问题的分析与解决方案

问题背景

在 Symfony 6.4 环境中使用 DoctrineExtensions 时，开发者可能会遇到一个常见错误提示："The service 'gedmo.listener.softdeleteable' has a dependency on a non-existent service 'annotation_reader'"。这个问题源于 Symfony 6.4 开始逐步弃用传统的注解(annotation)系统，转而全面支持属性(attribute)系统。

技术解析

DoctrineExtensions 是一个为 Doctrine ORM 提供行为扩展功能的流行库，其中包括软删除(SoftDeleteable)、时间戳(Timestampable)等实用功能。传统上，这些功能都是通过注解方式配置的。

随着 PHP 8.0 引入原生属性支持，现代 PHP 框架和库都在向属性系统迁移。DoctrineExtensions 从 3.x 版本开始已经全面支持属性配置方式，但为了向后兼容，仍然保留了注解支持。

解决方案

方案一：使用属性替代注解

DoctrineExtensions 已经完全支持属性配置方式。开发者可以：

1. 移除服务定义中的 setAnnotationReader 调用
2. 将实体类中的注解配置转换为属性配置

例如，软删除功能可以从：

/**
 * @Gedmo\SoftDeleteable(fieldName="deletedAt", timeAware=false)
 */
class YourEntity

改为：

#[Gedmo\SoftDeleteable(fieldName: "deletedAt", timeAware: false)]
class YourEntity

方案二：显式配置属性阅读器

如果项目需要显式配置阅读器，可以：

1. 创建 Gedmo\Mapping\Driver\AttributeReader 服务
2. 在服务配置中将此阅读器传递给相应的监听器

方案三：临时兼容方案

对于需要暂时保持注解方式的项目，可以安装 doctrine/annotations 包：

composer require doctrine/annotations

但这只是过渡方案，建议尽快迁移到属性系统。

最佳实践建议

1. 新项目：直接使用属性配置方式，避免引入注解依赖
2. 旧项目迁移：
   • 先确保 DoctrineExtensions 版本在 3.x 以上
   • 逐步将实体类中的注解转换为属性
   • 移除服务配置中的注解阅读器依赖
3. 混合环境：可以同时配置注解和属性阅读器，但会增加复杂性

技术前瞻

随着 PHP 生态全面转向属性系统，注解方式将逐步退出历史舞台。DoctrineExtensions 的这种变化代表了现代 PHP 开发的最佳实践方向。开发者应该尽早适应这种变化，以保持项目的长期可维护性。

通过采用属性系统，项目不仅能够获得更好的性能（因为属性是 PHP 原生特性），还能简化依赖关系，提高代码的可读性和可维护性。