使用PDO fetchAll时如何自动将MySQL DateTime转为PHP DateTime

结论 #

原生PDO本身没有内置直接将MySQL DateTime字段自动转为PHP DateTime对象的映射能力，但可以通过以下两种常用方案实现自动转换，无需每次手动处理字符串转DateTime的逻辑：

方案1：通过实体类内置转换逻辑（无额外依赖） #

利用PDO FETCH_CLASS 模式的属性赋值规则，在类中实现自动转换：

• 对于需要转换的日期属性，声明为非public权限，配合__set魔术方法自动识别处理：

class MyPHPClass {
    public int $id;
    public string $content;
    // 非public属性赋值会触发__set
    protected \DateTime $created_at;

    public function __set(string $name, mixed $value): void
    {
        // 匹配日期字段，自动转换为DateTime对象
        if ($name === 'created_at' && is_string($value)) {
            $this->created_at = new \DateTime($value);
            return;
        }
        // 其他字段直接赋值
        $this->$name = $value;
    }

    // 加对应getter方法获取日期属性即可
    public function getCreatedAt(): \DateTime
    {
        return $this->created_at;
    }
}

查询时不需要修改原有调用逻辑：

$stmt->execute();
$results = $stmt->fetchAll(PDO::FETCH_CLASS, MyPHPClass::class);

注：如果存在多个DateTime类型字段，只需在__set方法中扩展判断规则即可。

方案2：注解+自定义转换器（注解驱动实现） #

如果需要通用的注解配置能力，可以自己封装轻量转换逻辑，符合你要求的注解式实现：

1. 首先定义日期字段注解（PHP 8.0+支持原生注解）：

#[Attribute(Attribute::TARGET_PROPERTY)]
class DateTimeField {}

2. 在实体类中标记需要转换的日期属性：

class MyPHPClass {
    public int $id;
    public string $content;
    #[DateTimeField]
    public \DateTime $created_at;
}

3. 封装自动转换的fetch方法：

function fetchAllWithAutoConvert(PDOStatement $stmt, string $className): array
{
    $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
    $results = [];
    // 预解析类的注解标记的日期字段
    $reflection = new ReflectionClass($className);
    $dateFields = [];
    foreach ($reflection->getProperties() as $property) {
        if (!empty($property->getAttributes(DateTimeField::class))) {
            $dateFields[] = $property->getName();
        }
    }
    // 批量转换实例化
    foreach ($rows as $row) {
        $obj = new $className();
        foreach ($row as $key => $value) {
            if (in_array($key, $dateFields) && is_string($value)) {
                $obj->$key = new \DateTime($value);
                continue;
            }
            $obj->$key = $value;
        }
        $results[] = $obj;
    }
    return $results;
}

调用时替换原有fetchAll逻辑即可：

$stmt->execute();
$results = fetchAllWithAutoConvert($stmt, MyPHPClass::class);

补充说明 #

如果不想自行封装转换逻辑，也可以使用成熟的ORM组件（如Eloquent、Doctrine），这类组件都内置了完善的类型自动转换能力，支持注解配置字段类型，无需自行实现转换逻辑。

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