PHP中如何实现类似TypeScript Partial的类属性可选功能？

PHP本身没有像TypeScript那样原生的Partial工具类型语法，但可以通过反射与动态类生成的方式实现你需要的效果，完全满足你提出的三条规则：

• 不修改原类
• 无需手动在子类中编写构造函数
• 将原类的所有属性转为可选参数

实现核心函数 #

我们可以编写一个Partial函数，通过反射分析原类的构造参数，动态生成符合要求的子类：

function Partial(string $className): string {
    $reflection = new ReflectionClass($className);
    $constructor = $reflection->getConstructor();
    if (!$constructor) {
        return $className;
    }

    $parameters = $constructor->getParameters();
    $paramDefinitions = [];
    $paramNames = [];

    foreach ($parameters as $param) {
        $type = $param->getType() ? $param->getType()->__toString() : 'mixed';
        $paramName = $param->getName();
        // 将参数设为可选，默认值为null
        $paramDefinitions[] = "{$type}? \${$paramName} = null";
        $paramNames[] = "\${$paramName}";
    }

    $parentShortName = $reflection->getShortName();
    $partialClassName = "{$parentShortName}Partial";

    // 动态生成子类代码
    $classCode = <<<PHP
class $partialClassName extends $className {
    public function __construct({$paramDefinitions ? implode(', ', $paramDefinitions) : ''}) {
        parent::__construct(
            ...array_filter([
                {$paramNames ? implode(', ', $paramNames) : ''}
            ], fn(\$value) => \$value !== null)
        );
    }
}
PHP;

    eval($classCode);
    return $partialClassName;
}

使用示例 #

基于你提供的Registration类，按照以下方式使用：

// 生成Partial子类
$partialClass = Partial(Registration::class);
// 实例化时仅传递必要参数
$registration = new $partialClass(year: 2025);

// 或者直接使用动态生成的类名
$anotherRegistration = new RegistrationPartial(year: 2025, state_address: "CA");

关键说明 #

• 该函数通过反射自动读取原类的构造参数，动态生成子类的构造函数，无需手动编写子类代码；
• 子类构造函数将所有参数设为可选（带null默认值），调用父类构造函数时只传递非null的参数，保证原类readonly属性的赋值逻辑不受影响；
• 需要PHP 8.0及以上版本支持，因为用到了Nullable类型、构造属性提升以及箭头函数；
• 注意eval的安全风险：确保传入Partial函数的类名是可信的，避免注入恶意代码。生产环境中可以提前预生成子类文件，替代动态eval的方式。

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