PHP lazy object 如何延迟创建重量级服务

PHP 8.4 的 lazy object 适合把数据库连接、配置解析器或远程客户端这类重量级服务推迟到真正使用时再创建。官方入口是 https://www.php.net/manual/en/language.oop5.lazy-objects.php。最容易落地的是 ReflectionClass::newLazyGhost()：对象先进入依赖图，但构造函数不立即执行；第一次读取属性或调用会触发 initializer，初始化完成后继续按普通对象使用。

用 lazy ghost 把重量级服务推迟到第一次使用

下面用一个带配置的 ReportService 表示重量级服务。创建 lazy ghost 时不要把普通对象直接塞进闭包，而是接收 PHP 传入的对象，并在 initializer 内调用它的构造函数。这样对象身份保持不变，也不会在应用启动阶段建立连接。

config['name'];
    }
}

$reflector = new ReflectionClass(ReportService::class);
$service = $reflector->newLazyGhost(
    static function (ReportService $object): void {
        // 必须在原对象上完成初始化，不能返回另一个对象。
        $object->__construct(['name' => 'daily']);
    }
);

// 此时 initializer 尚未执行；真正读取状态时才会触发。
echo $service->summary();

newLazyGhost() 创建时不会调用构造函数，属性也还没有按普通实例完成初始化。initializer 必须返回 null，并在原对象上补齐可用状态。若类没有实例属性，PHP 可能直接返回普通对象，因此不要把 lazy 当成所有类都有效的包装层。

ghost 和 proxy 的选择取决于谁拥有实例

ghost 的优点是初始化后几乎等同于从未惰性化的对象，适合服务容器同时掌控实例和初始化过程。若真实服务必须由外部工厂创建，例如第三方 SDK 或不可直接调用构造函数的对象，则使用 newLazyProxy()：

newLazyProxy(
    static function (): ApiClient {
        // 这里可以交给容器、配置工厂或 SDK 创建真实实例。
        return ApiClientFactory::create(['endpoint' => '/reports']);
    }
);

// 第一次方法调用才要求工厂创建真实客户端。
$response = $client->fetch();

proxy 初始化后会把操作转发给真实实例，但 proxy 与真实实例是两个不同身份。需要放入 WeakMap、做严格 === 比较或依赖对象 ID 时，这个差异必须写进设计说明。

什么时候会触发初始化，什么时候应该显式触发

读取实例属性、调用实例方法、遍历对象状态等观察或修改行为，都可能成为自动触发点。仅检查“是否还是惰性对象”不会替你初始化，可以先做状态判断，再在合适的业务边界显式预热：

isUninitializedLazyObject($service)) {
    // 显式完成一次初始化；已初始化对象再次调用不会重复执行。
    $reflection->initializeLazyObject($service);
}

echo $service->summary();

序列化是另一个边界：默认序列化 lazy object 会触发初始化；如果只是希望保存尚未初始化的状态，可创建对象时传入 ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE，但恢复后的业务语义要单独设计，不能把未连接的服务当成可直接使用的缓存数据。

落地前的参数与边界清单

常见问题

lazy ghost 会自动调用原来的构造函数吗？

不会。必须在 initializer 中显式调用构造函数或完成等价的属性初始化。

什么时候不适合使用 lazy proxy？

需要严格比较对象身份、依赖对象 ID，或调用方必须拿到真实实例时，应先确认代理身份差异不会破坏业务。

如何确认对象是否仍未初始化？

使用对应的 ReflectionClass::isUninitializedLazyObject()；不要通过强制读取属性来“试探”，因为读取本身可能触发初始化。