This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
symfony/src/Symfony/Component/VarExporter
Nicolas Grekas 28f1ab67ca Merge branch '4.4' into 5.1
* 4.4:
  Use createMock() and use import instead of FQCN
2021-01-27 11:01:46 +01:00
..
Exception [VarExporter] unserialize() might throw an Exception on php 8. 2020-09-07 23:10:21 +02:00
Internal Merge branch '4.4' into 5.1 2020-09-08 16:19:54 +02:00
Tests Merge branch '4.4' into 5.1 2021-01-27 11:01:46 +01:00
.gitattributes add missing gitattributes for phpunit-bridge 2020-03-27 17:54:36 +01:00
.gitignore [VarExporter] a new component to serialize values to plain PHP code 2018-08-27 18:34:07 +02:00
CHANGELOG.md [HttpKernel] allow cache warmers to add to the list of preloaded classes and files 2020-04-04 11:52:45 +02:00
composer.json Merge branch '4.4' into 5.1 2021-01-10 17:29:19 +01:00
Instantiator.php Replace @return annotation by return type in final classes 2019-06-23 00:57:33 +02:00
LICENSE Bump license year 2021-01-01 10:24:35 +01:00
phpunit.xml.dist Merge branch '4.1' 2018-11-11 20:52:12 +01:00
README.md Fix link to documentation 2019-06-22 10:17:17 +02:00
VarExporter.php Use short array deconstruction syntax. 2020-10-28 21:42:29 +01:00

VarExporter Component

The VarExporter component allows exporting any serializable PHP data structure to plain PHP code. While doing so, it preserves all the semantics associated with the serialization mechanism of PHP (__wakeup, __sleep, Serializable, __serialize, __unserialize).

It also provides an instantiator that allows creating and populating objects without calling their constructor nor any other methods.

The reason to use this component vs serialize() or igbinary is performance: thanks to OPcache, the resulting code is significantly faster and more memory efficient than using unserialize() or igbinary_unserialize().

Unlike var_export(), this works on any serializable PHP value.

It also provides a few improvements over var_export()/serialize():

  • the output is PSR-2 compatible;
  • the output can be re-indented without messing up with \r or \n in the data
  • missing classes throw a ClassNotFoundException instead of being unserialized to PHP_Incomplete_Class objects;
  • references involving SplObjectStorage, ArrayObject or ArrayIterator instances are preserved;
  • Reflection*, IteratorIterator and RecursiveIteratorIterator classes throw an exception when being serialized (their unserialized version is broken anyway, see https://bugs.php.net/76737).

Resources