如何修改PHP自定义类型CustomType以支持属性默认值设置

问题核心 #

PHP语法规则限制：非内置类型的类属性，不能直接用CustomType("1")这种实例化表达式作为默认值，只能设为null（属性类型允许nullable时）或符合要求的常量值。要实现类似内置类型的默认值写法，需从自定义类和dataclass库的反射逻辑两方面调整。

方案1：自定义类配合常量实例（适配dataclass库） #

步骤1：修改CustomType类 #

通过静态方法生成默认实例，并用类常量存储该实例（PHP类常量不能直接初始化对象，需在类外赋值）：

class CustomType {
    public string $item;
    // 声明常量用于存储默认实例
    public const DEFAULT = null;

    public function __construct(string $item) {
        $this->item = $item;
    }

    // 静态方法生成默认实例
    public static function default(): self {
        return new self("1");
    }
}

// 初始化类常量为默认实例
CustomType::DEFAULT = CustomType::default();

步骤2：NewClass中使用默认值 #

直接引用CustomType的常量作为属性默认值：

class NewClass {
    public CustomType $test = CustomType::DEFAULT;
}

步骤3：调整dataclass库的反射验证逻辑 #

找到库中使用ReflectionClass::getDefaultProperties()获取默认值后的验证代码，修改为允许自定义类型的常量实例：

// 替换原有的默认值验证逻辑
$propertyType = $reflectionProperty->getType();
$defaultValue = $reflectionProperty->getDefaultValue();

if (!$propertyType->isBuiltin()) {
    $typeName = $propertyType->getName();
    // 检查默认值是否为该类型实例，或指向该类型的DEFAULT常量
    if ($defaultValue !== null && !($defaultValue instanceof $typeName)) {
        if (defined("$typeName::DEFAULT") && constant("$typeName::DEFAULT") instanceof $typeName) {
            // 将常量引用替换为实际实例
            $defaultValue = constant("$typeName::DEFAULT");
        } else {
            throw new Exception("Property of type {$typeName} only allows null or an instance of the type as default value");
        }
    }
}

方案2：用PHP枚举替代自定义类（更简洁） #

如果CustomType的取值是固定的，直接用PHP 8.1+的枚举类型，枚举实例可直接作为属性默认值，无需修改dataclass库：

enum CustomType: string {
    case DEFAULT = "1";

    public function getItem(): string {
        return $this->value;
    }
}

class NewClass {
    public CustomType $test = CustomType::DEFAULT;
}

说明 #

方案1适合需要灵活实例化的自定义类场景，需配合调整dataclass的验证逻辑；方案2适合固定取值的场景，完全符合PHP语法规范，无需额外修改库代码。

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