ReflectionClass::newLazyProxy

(PHP 8 >= 8.4.0)

ReflectionClass::newLazyProxy — Creates a new lazy proxy instance

说明

public ReflectionClass::newLazyProxy(callable $factory, int $options = 0): object

Creates a new lazy proxy instance of the class, attaching the factory function to it. The constructor is not called, and properties are not set to their default values. When an attempt is made to observe or modify the proxy's state for the first time, the factory function is called to provide a real instance, which is then attached to the proxy. After this, all subsequent interactions with the proxy are forwarded to the real instance. See Initialization Triggers and Initialization Sequence.

参数

factory

The factory is a callback with the following signature:

factory(object $object): object

object: The object being initialized. At this point, the object is no longer marked as lazy, and accessing it does not trigger initialization again.

The factory function must return an object, referred to as the real instance, which is then attached to the proxy. This real instance must not be lazy and must not be the proxy itself. If the real instance does not have the same class as the proxy, the proxy's class must be a subclass of the real instance's class, without additional properties, and must not override the __destruct() or __clone() methods.

options

options can be a combination of the following flags:

ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE: By default, serializing a lazy object triggers its initialization. Setting this flag prevents initialization, allowing lazy objects to be serialized without being initialized.

返回值

Returns a lazy proxy instance. If the object has no properties, or if all its properties are static or virtual, a normal (non-lazy) instance is returned. See also Lifecycle of Lazy Objects.

错误／异常

An Error if the class is internal or extends an internal class except stdClass.

示例

示例 #1 Basic usage

<?php
class Example {
    public function __construct(public int $prop) {
        echo __METHOD__, "\n";
    }
}

$reflector = new ReflectionClass(Example::class);
$object = $reflector->newLazyProxy(function (Example $object) {
$realInstance = new Example(1);
     return $realInstance;
});

var_dump($object);
var_dump($object instanceof Example);

// Triggers initialization, and forwards the property fetch to the real instance
var_dump($object->prop);

var_dump($object);
?>

以上示例会输出：

lazy proxy object(Example)#3 (0) {
  ["prop"]=>
  uninitialized(int)
}
bool(true)
Example::__construct
int(1)
lazy proxy object(Example)#3 (1) {
  ["instance"]=>
  object(Example)#4 (1) {
    ["prop"]=>
    int(1)
  }
}

参见

Lazy objects
ReflectionClass::newLazyGhost() - Creates a new lazy ghost instance
ReflectionClass::newInstanceWithoutConstructor() - 创建新的类实例而不调用它的构造函数
ReflectionClass::resetAsLazyProxy() - Resets an object and marks it as lazy
ReflectionClass::markLazyObjectAsInitialized() - Marks a lazy object as initialized without calling the initializer or factory
ReflectionClass::initializeLazyObject() - Forces initialization of a lazy object
ReflectionClass::isUninitializedLazyObject() - Checks if an object is lazy and uninitialized
ReflectionProperty::setRawValueWithoutLazyInitialization() - Set raw property value without triggering lazy initialization
ReflectionProperty::skipLazyInitialization() - Marks property as non-lazy
ReflectionProperty::isLazy() - Checks whether a property is lazy

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注

此页面尚无用户贡献的备注。

备份地址：http://www.lvesu.com/blog/php/reflectionclass.newlazyproxy.php