34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
|
Symfony Polyfill / DeepClone
|
|||
|
|
============================
|
|||
|
|
|
|||
|
|
This package provides a pure-PHP implementation of the functions and exception
|
|||
|
|
classes from the [deepclone extension](https://github.com/symfony/php-ext-deepclone):
|
|||
|
|
|
|||
|
|
- `deepclone_to_array(mixed $value, ?array $allowed_classes = null, bool $allow_named_closures = false): array`
|
|||
|
|
— converts any serializable PHP value graph into a pure array (only scalars
|
|||
|
|
and nested arrays, no objects).
|
|||
|
|
- `deepclone_from_array(array $data, ?array $allowed_classes = null, bool $allow_named_closures = false): mixed`
|
|||
|
|
— rebuilds the value graph from the array, preserving object identity,
|
|||
|
|
references, cycles, and private property state.
|
|||
|
|
- `DeepClone\NotInstantiableException` and `DeepClone\ClassNotFoundException`
|
|||
|
|
|
|||
|
|
When the native `deepclone` extension is loaded, this polyfill does nothing —
|
|||
|
|
the extension provides the same functions 4–5× faster.
|
|||
|
|
|
|||
|
|
The array representation preserves PHP's copy-on-write for strings and scalar
|
|||
|
|
arrays, making repeated cloning of a prototype significantly more memory
|
|||
|
|
efficient than `unserialize(serialize())`. It also serves as a cache-friendly
|
|||
|
|
serialization format: when dumped via `var_export()` into a `.php` file,
|
|||
|
|
OPcache maps the array into shared memory, making deserialization essentially
|
|||
|
|
free.
|
|||
|
|
|
|||
|
|
This is the same wire format used by Symfony's `VarExporter\DeepCloner`.
|
|||
|
|
|
|||
|
|
More information can be found in the
|
|||
|
|
[main Polyfill README](https://github.com/symfony/polyfill/blob/main/README.md).
|
|||
|
|
|
|||
|
|
License
|
|||
|
|
=======
|
|||
|
|
|
|||
|
|
This library is released under the [MIT license](LICENSE).
|