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

一个 PHP 服务的容器里挂了十几个仓储对象，首页只真正用到两个。把所有对象都在构造函数里连数据库，启动时间和连接数都会被无谓地抬高。PHP 8.4 的 Lazy Objects 给了一个更贴近运行时的选择：用 newLazyGhost() 做原地初始化，或用 newLazyProxy() 延后创建真实对象，但两者都必须先划清初始化触发点和构造函数边界。

先看两种对象到底延迟了什么

Lazy Object 不是把任意构造函数自动改成异步任务，而是把“对象何时准备好”交给 Reflection API。PHP 8.4 提供了 Ghost 和 Proxy 两条路径：Ghost 保留当前对象身份，在 initializer 中把状态写回这个对象；Proxy 则在 factory 中创建另一个真实实例，并把后续交互转过去。

两个入口都不会在创建瞬间按普通方式完整构造对象。这个细节很关键：如果 initializer 或 factory 依赖构造函数已经完成，就会把旧的对象生命周期假设带进新 API。

用 Lazy Ghost 延后一个配置对象

下面的对象模拟按租户读取配置的服务。注册容器时只拿到一个延迟对象；第一次调用 dsn() 时才查询配置并写入属性。

dsn;
    }

    public function load(string $dsn): void
    {
        $this->dsn = $dsn;
    }
}

$reflection = new ReflectionClass(TenantConfig::class);
$config = $reflection->newLazyGhost(function (TenantConfig $object): void {
    // 真实项目中这里可以读取配置中心，但不要把网络重试藏在 getter 里。
    $object->load('mysql:host=db.internal;dbname=orders');
});

echo "容器注册完成\n";
echo $config->dsn(), "\n";

第一行输出后对象仍未初始化；读取 dsn 会触发 initializer，之后 dsn() 看到的就是已经填好的状态。initializer 执行时对象已经不再是 lazy 状态，所以回调内部可以直接访问它的属性和方法。

这里不要为了证明效果而在注册阶段调用 var_dump($config)、遍历属性或做序列化。它们可能观察对象状态，测试就不再是在测“延迟创建”。

用 Lazy Proxy 把昂贵服务推迟到第一次调用

Proxy 的判断点不在“怎么填充当前对象”，而在“真正的实现何时被工厂选出来”。例如报表服务有数据库版和缓存版，容器先注册一个统一接口，首次调用时才创建数据库实现：

 $tenantId, 'source' => 'sql'];
    }
}

$reflection = new ReflectionClass(SqlReportService::class);
$report = $reflection->newLazyProxy(function (SqlReportService $proxy): SqlReportService {
    echo "factory called\n";
    return new SqlReportService();
});

$result = $report->summary(7);
var_export($result);

第一次调用会让 factory 返回真实实例，后续方法调用都转发给这个实例。工厂的返回值必须是兼容的、非 lazy 的对象；如果把另一个未初始化代理返回进去，问题会从一次延迟变成难以追踪的嵌套初始化。

初始化触发点决定了架构收益

延迟对象不是“永远不初始化”。官方手册把读取或修改状态、调用方法、某些对象检查和序列化都视为需要仔细核对的边界。项目接入时可以先用一个小表把风险写进代码评审：

PHP 提供 ReflectionClass::initializeLazyObject() 主动初始化对象。它适合把初始化放在一个可观测的阶段，例如请求进入后先完成关键依赖准备，而不是让第一个业务 getter 承担全部延迟。

上线前把异常、序列化和对象身份测一遍

initializer 失败后不要假设对象已经可复用

配置中心、数据库或文件读取失败时，initializer 应抛出明确异常并记录对象类型、租户标识和耗时，不要静默填入默认连接串。是否允许下一次访问重试，要由容器策略决定。

Proxy 和 Ghost 的身份语义不同

Ghost 初始化前后仍是同一个对象；Proxy 的代理与真实实例是不同对象，调用方如果保存了对象身份、做严格比较或依赖序列化，需要单独验证。

序列化是最容易偷走延迟收益的地方

会话、缓存和队列 payload 都可能序列化服务对象。先确认是否真的需要把对象放进 payload，再决定是否使用 ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE 等选项；不要用选项掩盖不可序列化的外部资源。

常见问题

PHP 8.4 Lazy Ghost 会调用构造函数吗？

创建 lazy ghost 时不会按普通实例化流程调用构造函数。initializer 应负责把对象恢复到业务可用状态，因此旧构造函数里的副作用不能默认已经发生。

Lazy Proxy 和 Lazy Ghost 该怎么选？

需要原对象身份并希望原地填充状态时选 Ghost；需要由工厂创建真实实现、再把调用转发过去时选 Proxy。

怎么强制提前初始化 Lazy Object？

可以通过对应的 ReflectionClass::initializeLazyObject() 主动触发，并把这一步放在可观测的请求或任务阶段。

Lazy Object 适合把数据库连接放进对象里吗？

可以延迟创建依赖，但数据库连接、事务和请求生命周期仍应由连接池或资源管理层负责；不要让一个 lazy getter 隐藏长时间重试和事务开启。

Lazy Objects 的价值不只是“晚一点 new”，而是把初始化边界显式交给代码。先用 Ghost 和 Proxy 的身份差异做设计判断，再对第一次调用、主动初始化、异常和序列化分别测量，才能把启动收益换成稳定的运行时行为。