DoctrineExtensions 日志查询性能优化实战

背景介绍

DoctrineExtensions 是一个为 Doctrine ORM 提供行为扩展功能的 PHP 库，其中的 Loggable 扩展能够自动记录实体对象的变更历史。在实际项目中，随着业务数据增长，日志表（ext_log_entries）会积累大量记录，导致查询性能显著下降。

性能问题分析

当 ext_log_entries 表数据量达到 70 万条时，典型的日志查询语句执行时间可能超过 8 秒。问题查询通常具有以下特征：

1. 使用多个 LIKE 条件进行模糊匹配
2. 对几乎所有字段都进行了查询
3. 包含 DISTINCT 和 ORDER BY 子句
4. 没有充分利用索引

优化方案

1. 添加必要索引

为关键字段创建索引是提升查询性能的基础措施。对于日志表，建议为以下字段添加索引：

• action（操作类型）
• object_id（关联对象ID）
• object_class（对象类名）
• username（操作用户）

可以通过创建自定义日志实体类来定义索引：

#[ORM\Entity]
#[ORM\Table(name: 'ext_log_entries')]
#[ORM\Index(name: 'action_idx', columns: ['action'])]
#[ORM\Index(name: 'object_idx', columns: ['object_id', 'object_class'])]
#[ORM\Index(name: 'username_idx', columns: ['username'])]
class CustomLogEntry extends LogEntry
{
    // 继承基类
}

2. 优化查询条件

避免使用全字段模糊查询，特别是对大数据字段（如 data 字段）的 LIKE 操作。建议：

1. 将 action 字段改为枚举查询
2. 为 object_class 使用精确匹配
3. 限制对 data 字段的查询

3. 前端查询优化

如果使用 EasyAdmin 等管理后台，可以配置更高效的过滤器：

filters:
    - property: 'action'
      type: 'choice'
      value_type_options:
          choices:
              'create': 'create'
              'update': 'update'
              'remove': 'remove'
    - property: 'objectClass'
      type: 'choice'
      # 配置可选的实体类列表

4. 数据归档策略

对于长期不用的历史日志，建议：

1. 定期归档旧数据
2. 实现分表存储策略
3. 考虑使用专门的日志存储方案（如 ELK 栈）

实施建议

1. 先在测试环境验证索引效果
2. 逐步优化查询条件，避免一次性全改
3. 监控优化后的查询性能
4. 考虑使用查询缓存机制

总结

DoctrineExtensions 的日志功能非常强大，但在大数据量场景下需要特别注意性能优化。通过合理的索引设计、查询优化和归档策略，可以显著提升日志查询性能，确保系统长期稳定运行。