ReflectionClass::newLazyGhost
新しいレイジーゴーストインスタンスを作成する
説明
public object ReflectionClass::newLazyGhost(callable $initializer, int $options = 0)
クラスの新しいレイジーゴーストインスタンスを作成し、
initializer をアタッチします。コンストラクタは呼び出されず、
プロパティはデフォルト値に設定されません。オブジェクトの状態を
初めて参照または変更する時に、
initializerをにより自動的に初期化されます。
初期化トリガーおよび
初期化シーケンス
を参照してください。
パラメータ
-
initializer
-
イニシャライザは以下のシグネチャを持つコールバックです:
void initializer(object $object)
-
object
-
初期化される
object。この時点では、
オブジェクトはもはやレイジーとしてマークされておらず、
アクセスしても再び初期化がトリガーされることはありません。
initializer関数は null を返すか、
値を返さない必要があります。
options-
optionsには以下のフラグを組み合わせて
指定できます:
-
ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE
-
デフォルトでは、レイジーオブジェクトのシリアライズは
初期化がトリガーされます。このフラグを設定すると、
初期化せずにシリアライズできるようになります。
戻り値
レイジーゴーストインスタンスを返します。オブジェクトにプロパティがない場合、または
そのプロパティがすべてstaticまたはvirtualの場合、通常の（レイジーではない）インスタンスが
返されます。
レイジーオブジェクトの
ライフサイクルも参照してください。
エラー / 例外
クラスが内部クラスであるか、stdClassを除く内部クラスを
拡張している場合、Errorをスローします。
例
例1 基本的な使用法
<?php
class Example {
public function __construct(public int $prop) {
echo __METHOD__, "\n";
}
}
$reflector = new ReflectionClass(Example::class);
$object = $reflector->newLazyGhost(function (Example $object) {
$object->__construct(1);
});
var_dump($object);
var_dump($object instanceof Example);
// 初期化をトリガーし、その後プロパティを取得します
var_dump($object->prop);
?>
lazy ghost object(Example)#3 (0) {
["prop"]=>
uninitialized(int)
}
bool(true)
Example::__construct
int(1)
参考
- レイジーオブジェクト
- ReflectionClass::newLazyProxy
- ReflectionClass::newInstanceWithoutConstructor
- ReflectionClass::resetAsLazyGhost
- ReflectionClass::markLazyObjectAsInitialized
- ReflectionClass::initializeLazyObject
- ReflectionClass::isUninitializedLazyObject
- ReflectionProperty::setRawValueWithoutLazyInitialization
- ReflectionProperty::skipLazyInitialization
- ReflectionProperty::isLazy