PHP 8.4 Lazy Objects 怎么用：Ghost 与 Proxy 的初始化边界

一个后台列表只需要展示订单号和金额，却在创建对象时顺手连上了详情服务，页面慢下来的原因往往不是 SQL 本身，而是对象初始化发生得太早。PHP 8.4 的 Lazy Objects 可以把初始化推迟到真正读取属性或调用需要状态的方法时，同时保留原来的对象类型和公开 API。关键是分清 Ghost、Proxy，以及“什么算观察对象状态”。

先用一个订单详情对象复现“初始化太早”

假设订单列表只拿到了 order_id，详情对象的构造函数却包含了远程配置读取。为了让初始化是否发生可见，下面的示例把构造函数输出一行日志。实际项目中，这里也可能是数据库查询、文件读取或依赖注入。

id}\n";
    }
}

$order = new OrderDetail(10086, 'Lin');
echo $order->id, "\n";

普通对象一旦执行 new OrderDetail()，构造函数就已经运行。列表页如果最终没有用到 customer，这次工作也无法回收。Lazy Objects 的价值在于让“是否初始化”从构造时机变成访问时机。

Ghost：在同一个对象身份里补齐属性

newLazyGhost() 返回的对象仍然是 OrderDetail，初始化器收到的也是这个对象。初始化发生时，在初始化器里调用构造函数或直接设置属性，外部持有的对象引用不会换掉。

id = $id;
        $this->customer = $customer;
    }
}

$reflection = new ReflectionClass(OrderDetail::class);
$order = $reflection->newLazyGhost(function (OrderDetail $object): void {
    $object->__construct(10086, 'Lin');
});

var_dump($reflection->isUninitializedLazyObject($order)); // true
echo $order->customer, "\n";                         // 触发初始化
var_dump($reflection->isUninitializedLazyObject($order)); // false

Ghost 适合“最终还是要得到这个类型的对象，但暂时不想填充全部状态”的场景。它的判断重点不是有没有调用方法，而是这次方法或属性访问有没有观察到需要初始化的属性。

Proxy：先拿代理，真正对象由工厂决定

newLazyProxy() 的初始化器返回一个真实对象。代理对外仍表现为声明的代理类，真实对象则由工厂决定。这个模式适合把创建逻辑放进容器或仓储，而不是把连接细节塞进业务对象。

newLazyProxy(function (): OrderReader {
    return new RemoteOrderReader(10086);
});

echo $reader->customerName(), "\n";

Proxy 的收益是把“如何创建真实实现”隔离出去，但代价也很明确：调试时要记得代理本身和真实对象不是同一个实例。需要固定身份或保存引用时，先确认自己要的是 Ghost 语义还是 Proxy 语义。

哪些动作会让 Lazy Object 提前醒来

最容易踩坑的是把调试动作当成无副作用观察。下面这些写法可能触发初始化：读取未初始化属性、让对象参与需要读取状态的操作、克隆对象，以及调用会访问有 backing storage 属性的方法。测试 Lazy Objects 时，日志打印和断言本身都要小心。

$reflection = new ReflectionClass(OrderDetail::class);
$order = $reflection->newLazyGhost(function (OrderDetail $object): void {
    $object->__construct(10086, 'Lin');
});

assert($reflection->isUninitializedLazyObject($order));
$reflection->initializeLazyObject($order); // 明确要求现在初始化
assert(!$reflection->isUninitializedLazyObject($order));

如果业务需要在边界处明确完成初始化，可以使用 initializeLazyObject()，而不是用一次看似普通的字符串拼接或调试输出“碰巧”触发它。显式初始化更容易写测试，也更容易解释耗时。

上线前用三组断言检查设计是否合理

1. 创建阶段断言初始化器没有运行，确认列表场景没有提前加载详情。
2. 第一次读取关键属性后断言初始化器只运行一次，确认没有重复连接或重复查询。
3. 对克隆、序列化、异常和析构路径单独测试，避免把 Lazy Object 当成普通空壳对象。

如果对象没有明显的昂贵初始化动作，或者团队成员需要频繁猜测“这次访问会不会加载”，就不建议为了少写一次构造调用而引入 Lazy Objects。它是底层能力，不是所有模型的默认写法。

常见问题与边界判断

PHP 8.4 Lazy Objects 只能用于 ORM 吗？

不是。它也适合依赖容器、远程客户端和按需加载的配置对象，但这些场景都要有明确的初始化成本和可测试的触发点。

Ghost 和 Proxy 该怎么选？

需要保持原对象身份并在其上填充属性时选 Ghost；需要由工厂返回另一种真实实现并转发调用时选 Proxy。

怎么确认对象还没有初始化？

使用对应 ReflectionClass 的 isUninitializedLazyObject() 做测试或诊断。不要把它当作业务字段，也不要用一次调试打印替代正式断言。

PHP 8.3 项目能直接运行这些代码吗？

不能。Lazy Objects 是 PHP 8.4 引入的 API，升级前应先在 CI 使用 PHP 8.4 运行最小示例，并为旧版本保留明确的工厂或普通构造路径。

小结：先定义触发点，再决定是否延迟

PHP 8.4 Lazy Objects 解决的是对象初始化时机，不是自动让所有对象变快。Ghost 负责原地填充，Proxy 负责工厂转发；两者都需要对属性读取、调试、克隆和显式初始化写出可验证的边界。把它放在 ORM 或容器的底层通常更合适，业务代码则应保持初始化规则可读。