Sonata Admin Bundle默认日期过滤器失效问题求助

我在Sonata Admin中为用户列表的createdAt字段配置默认日期过滤器，希望默认展示近一个月创建的用户，但配置后默认过滤器未生效。相关代码如下：

实体代码（Entity\User.php） #

#[ORM\Column(name: 'creation_date', type: 'datetime', nullable: true)]
private ?DateTime $createdAt = null;

Admin类代码（UserAdmin.php） #

protected function configureDatagridFilters(DatagridMapper $datagridMapper): void
{
    $datagridMapper->add('createdAt', DateTimeRangeFilter::class, [
                'field_type' => DateTimeRangePickerType::class,
            ])
    ...
}

protected function configureDefaultFilterValues(array &$filterValues): void
{
    $filterValues['createdAt'] = [
        'value' => [
            'start' =>  (new \DateTime())->modify('-1 month')->format('M d, Y, h:i:s a'),
            'end' => (new \DateTime())->format('M d, Y, h:i:s a'),
        ],
    ];
}

排查与解决步骤 #

1. 修正默认值结构与日期格式 #

你的默认值嵌套了value键，且使用的日期格式不符合Sonata过滤器的预期，导致无法解析。直接传递DateTime对象或标准ISO格式字符串即可：

protected function configureDefaultFilterValues(array &$filterValues): void
{
    $oneMonthAgo = (new \DateTime())->modify('-1 month');
    $now = new \DateTime();
    
    // 推荐：直接使用DateTime对象
    $filterValues['createdAt'] = [
        'start' => $oneMonthAgo,
        'end' => $now,
    ];

    // 备选：使用ISO格式字符串
    // $filterValues['createdAt'] = [
    //     'start' => $oneMonthAgo->format('Y-m-d H:i:s'),
    //     'end' => $now->format('Y-m-d H:i:s'),
    // ];
}

2. 确认过滤器字段映射（可选） #

虽然Sonata通常能通过属性名关联到数据库列，但如果存在映射问题，可以显式指定列名：

protected function configureDatagridFilters(DatagridMapper $datagridMapper): void
{
    $datagridMapper->add('createdAt', DateTimeRangeFilter::class, [
        'field_type' => DateTimeRangePickerType::class,
        'field_options' => [
            'field' => 'creation_date' // 对应ORM列名
        ]
    ]);
    // ...其他过滤器配置
}

3. 清除缓存 #

修改配置后执行缓存清除，确保新配置生效：

php bin/console cache:clear

4. 验证效果 #

进入用户列表页，检查日期过滤器是否自动填充近一个月的范围，同时查看SQL日志确认是否生成了creation_date的范围查询条件。

内容的提问来源于stack exchange，提问作者Emeric Sailly