如何使用PDO将数据库数据提取至带有枚举（Enum）属性的PHP类中？

首先得纠正你代码里的一个枚举语法错误，PHP 8.1+的枚举如果要关联标量值，必须指定底层类型，并且用=赋值，正确的写法是：

enum UserType: int
{
    case Master = 1;
    case Admin = 2;
    case Manager = 3;
}

回到你的问题：PDO的fetchObject会直接把数据库返回的原始整数赋值给User::$userType，但这个属性的类型是UserType枚举，类型不兼容所以抛出错误。下面给你几个实用的解决方案，从简单到通用：

方案1：用魔术方法__set自动转换枚举 #

在User类里添加__set方法，拦截私有属性的赋值操作，自动把整数转换成枚举实例：

class User
{
    private int $id;
    private string $name;
    private UserType $userType;

    public function __set(string $name, mixed $value): void
    {
        if ($name === 'userType' && is_int($value)) {
            // 用from()转换，无效值会抛出ValueError；如果要兼容无效值可以用tryFrom()
            $this->userType = UserType::from($value);
            return;
        }

        // 处理其他属性的赋值（如果需要）
        if (property_exists($this, $name)) {
            $this->$name = $value;
        }
    }

    // 可选：添加getter方法
    public function getId(): int { return $this->id; }
    public function getName(): string { return $this->name; }
    public function getUserType(): UserType { return $this->userType; }
}

这样fetchObject尝试给$userType赋值整数时，会自动触发__set完成类型转换，不需要修改你的数据库调用代码。

方案2：通用枚举自动转换工具（推荐） #

如果你的项目里有很多枚举属性需要处理，写一个通用的hydrate函数来自动转换所有枚举类型的属性，这样不用每个类都写__set：

function hydrateObjectEnums(object $object): void
{
    $reflection = new ReflectionObject($object);
    foreach ($reflection->getProperties() as $property) {
        $propertyType = $property->getType();
        // 检查属性类型是否是枚举
        if (!$propertyType instanceof ReflectionNamedType || !enum_exists($propertyType->getName())) {
            continue;
        }

        $property->setAccessible(true);
        $rawValue = $property->getValue($object);
        if (is_scalar($rawValue)) {
            $enumClass = $propertyType->getName();
            // 这里可以根据需求换成tryFrom()来处理无效值
            $property->setValue($object, $enumClass::from($rawValue));
        }
    }
}

然后修改你的fetchObject方法，在获取对象后调用这个函数：

public function fetchObject($sql, array $args = array(), string $class_name = "stdClass"): mixed {
    $stmt = self::$instance->prepare($sql);
    $stmt->execute(empty($args) ? [] : $args);
    
    $object = $stmt->fetchObject($class_name);
    if ($object !== false) {
        hydrateObjectEnums($object);
    }
    
    $stmt->closeCursor();
    return $object;
}

这个方案的优势是一劳永逸，不管你后续加多少枚举类型的属性，都不需要额外修改代码。

方案3：构造函数注入（更严谨） #

如果你希望用构造函数来确保对象的完整性，可以修改User类的构造函数，然后调整fetchObject方法来传递转换后的枚举：

// User类
class User
{
    public function __construct(
        private int $id,
        private string $name,
        private UserType $userType
    ) {}

    // Getter方法...
}

// 修改后的fetchObject
public function fetchObject($sql, array $args = array(), string $class_name = "stdClass"): mixed {
    $stmt = self::$instance->prepare($sql);
    $stmt->execute(empty($args) ? [] : $args);
    
    $row = $stmt->fetch(PDO::FETCH_ASSOC);
    if (!$row) {
        $stmt->closeCursor();
        return null;
    }

    // 处理枚举属性（如果是User类）
    if ($class_name === User::class && isset($row['userType'])) {
        $row['userType'] = UserType::from($row['userType']);
    }

    // 用反射创建对象并传递构造参数
    $reflection = new ReflectionClass($class_name);
    $object = $reflection->newInstanceArgs($row);
    
    $stmt->closeCursor();
    return $object;
}

这个方案更符合面向对象的严谨性，确保对象创建时所有属性都是正确的类型，但需要针对特定类做处理（或者扩展反射逻辑来通用化）。

额外注意事项 #

• 如果数据库中可能存在无效的枚举值，建议用UserType::tryFrom($value)代替from()，它会在值无效时返回null，你可以根据业务逻辑处理这种情况（比如抛出自定义异常或设置默认值）。
• 确保你的PDO连接没有开启PDO::ATTR_STRINGIFY_FETCHES，否则数据库返回的整数会被转换成字符串，需要先转成int再调用枚举的from()方法。

内容的提问来源于stack exchange，提问作者João Paulo M. Bandolin