Symfony中如何将查询字符串日期映射为DateTimeInterface类型？

方案1：使用Symfony 6.4+的#[DateTime]属性（推荐） #

Symfony 6.4及以上版本提供了#[DateTime]属性，可直接将查询参数转换为DateTimeImmutable或DateTimeInterface类型，无需额外配置。

代码示例 #

use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Validator\Constraints\DateTime;
use OpenApi\Attributes as OA;

public function listOrders(
    #[OA\QueryParameter(
        name: 'since',
        in: 'query',
        description: 'Date de début de la recherche',
        required: false,
        schema: new OA\Schema(type: 'string', format: 'date')
    )]
    #[DateTime(format: 'Y-m-d')] // 可选：指定日期格式，默认支持多种标准格式
    ?DateTimeImmutable $since = null
): Response
{
    // $since已自动转换为DateTimeImmutable实例或null
    return new Response(json_encode(['since' => $since?->format('Y-m-d')]));
}

说明 #

• 该属性依赖Symfony的validator组件，未安装可执行composer require symfony/validator。
• 若不指定format，默认支持ISO 8601等多种标准日期格式。

方案2：低版本Symfony适配方案 #

方法A：手动转换（快速实现） #

直接从Request对象中获取查询参数并手动转换：

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use OpenApi\Attributes as OA;

public function listOrders(
    Request $request,
    #[OA\QueryParameter(
        name: 'since',
        in: 'query',
        description: 'Date de début de la recherche',
        required: false,
        schema: new OA\Schema(type: 'string', format: 'date')
    )]
): Response
{
    $sinceString = $request->query->get('since');
    $since = null;
    
    if ($sinceString) {
        $since = DateTimeImmutable::createFromFormat('Y-m-d', $sinceString);
        // 可选：验证日期有效性
        if (!$since) {
            return new Response('无效的日期格式', 400);
        }
    }

    // 业务逻辑处理
    return new Response(json_encode(['since' => $since?->format('Y-m-d')]));
}

方法B：自定义参数解析器 #

创建专门处理查询参数转DateTime的解析器：

// src/Controller/ArgumentResolver/QueryDateTimeValueResolver.php
namespace App\Controller\ArgumentResolver;

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpKernel\Controller\ArgumentValueResolverInterface;
use Symfony\Component\HttpKernel\ControllerMetadata\ArgumentMetadata;

class QueryDateTimeValueResolver implements ArgumentValueResolverInterface
{
    public function supports(Request $request, ArgumentMetadata $metadata): bool
    {
        return (is_subclass_of($metadata->getType(), \DateTimeInterface::class) || $metadata->getType() === \DateTimeInterface::class)
            && $request->query->has($metadata->getName());
    }

    public function resolve(Request $request, ArgumentMetadata $metadata): iterable
    {
        $dateString = $request->query->get($metadata->getName());
        $type = $metadata->getType();
        
        if ($type === \DateTimeImmutable::class || is_subclass_of($type, \DateTimeImmutable::class)) {
            yield \DateTimeImmutable::createFromFormat('Y-m-d', $dateString) ?: null;
        } else {
            yield \DateTime::createFromFormat('Y-m-d', $dateString) ?: null;
        }
    }
}

在services.yaml中注册解析器：

services:
    App\Controller\ArgumentResolver\QueryDateTimeValueResolver:
        tags: ['controller.argument_value_resolver']

之后即可在控制器中直接使用类型声明：

use Symfony\Component\HttpFoundation\Response;
use OpenApi\Attributes as OA;

public function listOrders(
    #[OA\QueryParameter(
        name: 'since',
        in: 'query',
        description: 'Date de début de la recherche',
        required: false,
        schema: new OA\Schema(type: 'string', format: 'date')
    )]
    ?DateTimeImmutable $since = null
): Response
{
    // 正常使用$since
    return new Response(json_encode(['since' => $since?->format('Y-m-d')]));
}

原代码问题说明 #

你调试发现$request->attributes->has($argument->getName())返回false，是因为默认的DateTimeValueResolver仅从request的**路由属性（attributes）**中读取值，而查询参数（query string）不在该集合内，因此需要专门处理查询参数的解析逻辑，上述方案均可解决该问题。

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