PHP Lazy Objects 延迟初始化实体的状态边界

PHP 8.4 把 Lazy Objects 放进了 Reflection API，适合把昂贵的实体初始化推迟到真正需要对象状态的时刻。它的关键不是“对象晚一点 new”，而是要先选对状态模型：Lazy Ghost 在原对象上填充属性，Lazy Proxy 则把访问转给另一个真实实例。

如果初始化逻辑由当前代码掌握，优先考虑 Lazy Ghost；如果真实对象由工厂或其他组件创建，使用 Lazy Proxy。生产代码还要显式处理属性访问、序列化、克隆、异常回滚和对象身份。

先区分 Lazy Ghost 与 Lazy Proxy

Ghost 适合实体本身负责完成填充，例如从仓储读取一行数据并写入同一个对象。Proxy 更像一个稳定的入口，首次访问时由工厂创建真正的实体；代理的类型外观可以保持不变，但代理和真实实例的对象身份不同。

下面的示例只展示选择关系，数据访问可以替换成仓储、HTTP 客户端或缓存读取。回调里的中文注释说明了资源边界，避免把示意代码误当成某个 ORM 的内部实现。

newLazyGhost(function (User $user): void {
    // 初始化器只负责填充当前实体，不替换对象本身。
    $user->id = 7;
    $user->name = 'Ada';
});

$proxyRef = new ReflectionClass(User::class);
$proxy = $proxyRef->newLazyProxy(function (User $proxy): User {
    // 工厂返回独立实例；代理和实例不要混用身份判断。
    $user = new User();
    $user->id = 8;
    $user->name = 'Grace';
    return $user;
});

用状态判断把初始化边界说清楚

不要用“属性当前有没有值”猜测对象是否仍然 lazy。ReflectionClass 提供了明确的判断和强制初始化方法。首次访问属性、修改属性、读取对象变量、序列化、JSON 编码或克隆，都可能跨过初始化边界；只调用一个不读取状态的方法，不一定会触发初始化。

newLazyGhost(function (User $user): void {
    // 真实项目中这里应处理查询失败，并避免泄漏连接等外部资源。
    $user->id = 9;
    $user->name = 'Lin';
});

if ($ref->isUninitializedLazyObject($user)) {
    // 需要确定状态时显式触发，避免后续序列化突然执行 I/O。
    $ref->initializeLazyObject($user);
}

echo $user->name; // 已初始化后再读取属性，不会再次调用 initializer。

如果实体的主键已经从路由或查询结果得知，可以用 ReflectionProperty::skipLazyInitialization() 或 setRawValueWithoutLazyInitialization() 标记已知字段。但这要求初始化器知道哪些属性已被外部填充，否则容易出现“主键是新的、其余字段来自旧数据”的半状态对象。

初始化失败、序列化和身份边界

初始化器抛出异常时，Lazy Object 会恢复对象自身在初始化前的状态，并重新保持 lazy；已经写入数据库、发出的请求、修改的缓存等外部副作用不会被引擎回滚。因此初始化器应尽量先准备数据，最后一次性写入对象，并把可重试的异常留在应用层处理。

把旧实体接入 PHP 8.4 的迁移清单

迁移时先确认构造器是否有连接、日志或事件等副作用；有副作用的实体不要直接把构造器搬进 initializer。接着决定哪些字段必须在首个属性访问前可用，再为 isUninitializedLazyObject()、失败重试和序列化分别写测试。最后单独测试 Ghost 与 Proxy 的 spl_object_id()、WeakReference 和严格相等结果，避免代理层改变缓存键或集合行为。

实际落地的最小原则是：Ghost 管好“同一对象如何补齐状态”，Proxy 管好“入口对象如何找到真实对象”；两者都不替应用层负责事务、网络请求或外部副作用。

常见问题

Lazy Ghost 初始化后还是原来的对象吗？

是。Ghost 在原对象上填充属性，初始化前后对象身份不变；这也是它适合实体和集合引用的原因。

Lazy Proxy 能直接和真实对象用严格相等比较吗？

不能默认这样假设。代理和工厂返回的真实实例是不同对象，缓存或弱引用逻辑应明确保存哪一个身份。

初始化器失败后，已经发出的请求会自动撤销吗？

不会。引擎只恢复对象自身的初始化状态，数据库写入、网络请求和其他对象变更需要应用层的事务或补偿机制。