Document lazy objects #3975
Document lazy objects #3975
Conversation
arnaud-lb
force-pushed
the
lazy-objects
branch
from
8323e4c to
007297f
Compare
| $reflector = new ReflectionClass(Example::class); | ||
| $lazyObject = $reflector->newLazyGhost(function (Example $object) { | ||
| // Initialize object in-place | ||
| $object->__construct(1); |
There was a problem hiding this comment.
I hate seeing ->__construct(), but that likely inherent to lazy ghost (and irrelevant to this PR anyway).
language/oop5/lazy-objects.xml
Outdated
| during the final initialization step). However, the proxy can be used | ||
| for decisions based on the values of initialized properties, the class, | ||
| the object itself, or its identity. For instance, the initializer might | ||
| use an initialized property’s value when creating the real instance. |
There was a problem hiding this comment.
I think we're apos elsewhere, so likely want to stick with it (for now):
| use an initialized property’s value when creating the real instance. | |
| use an initialized property's value when creating the real instance. |
Oh, just noticed that you're using ’ elsewhere, so maybe stick with that.
There was a problem hiding this comment.
Actually I've been inconsistent with this. I will unify this. Which way is preferred?
There was a problem hiding this comment.
The right way[TM] would be to use typographic apostrophes (i.e. ’), but I assume that we mostly use plain apostrophes (i.e. ') so far. Maybe this can be changed at some point in the future without disturbing translators (i.e. skip-revcheck).
Perhaps @Crell has something to say about this.
There was a problem hiding this comment.
My feeling is that in technical documentation, just use ' and be done with it. Messing with typographical apostrophes and quotes just creates hassles around character encoding. So just stick with the simple characters on your keyboard.
reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml
Outdated
Show resolved
Hide resolved
reference/reflection/reflectionproperty/skiplazyinitialization.xml
Outdated
Show resolved
Hide resolved
| <row> | ||
| <entry>8.4.0</entry> | ||
| <entry> | ||
| Added: Support for <link linkend="language.oop5.lazy-objects">Lazy Objects</link>. | ||
| </entry> | ||
| </row> | ||
| <row> | ||
| <entry>8.1.0</entry> | ||
| <entry> |
There was a problem hiding this comment.
Aside, we probably need to document about typing constants and readonly
RFC: https://wiki.php.net/rfc/lazy-objects