使用PDO FETCH_CLASS映射类前如何提前解析数据库JSON字段

解决方案 #

你可以通过以下两种常用方案实现JSON字段提前解析，不需要定义联合类型： #

方案1：使用PDO::FETCH_FUNC自定义实例化逻辑（推荐）

该方案逻辑直观无魔法行为，可控性最高，适配所有场景。
首先修改User类，直接将contact属性声明为你需要的类型：

<?php
class User {
    public string $first_name;
    public string $last_name;
    public object $contact; // 无需联合类型，直接声明为解析后的对象类型
}

修改PDO查询逻辑，用FETCH_FUNC替代FETCH_CLASS，在回调中完成JSON解析后再实例化对象：

$stmt = $DB->prepare("SELECT first_name, last_name, contact FROM users");
$stmt->execute();
$users = $stmt->fetchAll(PDO::FETCH_FUNC, function ($first_name, $last_name, $contact) {
    $user = new User();
    $user->first_name = $first_name;
    $user->last_name = $last_name;
    $user->contact = json_decode($contact);
    return $user;
});

方案2：使用魔术方法拦截属性赋值

如果不想修改原有PDO的FETCH_CLASS调用逻辑，可以通过__set方法在属性赋值阶段完成JSON解析，需要注意将需要处理的属性设置为非公开，否则魔术方法不会触发：
修改后的User类代码：

<?php
class User {
    public string $first_name;
    public string $last_name;
    protected object $contact; // 设置为非公开才会触发__set

    public function __set(string $name, mixed $value): void
    {
        if ($name === 'contact') {
            $this->contact = json_decode($value);
            return;
        }
        $this->$name = $value;
    }

    // 如需公开访问contact可新增getter方法
    public function getContact(): object
    {
        return $this->contact;
    }
}

原有PDO查询代码无需任何修改即可正常使用：

$stmt = $DB->prepare("SELECT first_name, last_name, contact FROM users");
$stmt->execute();
$users = $stmt->fetchAll(PDO::FETCH_CLASS, 'User');

注意事项 #

如果你的数据库中contact字段允许为NULL，建议在json_decode前增加非空判断，避免解析错误。

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