Introduction to Zend\Serializer¶
The Zend\Serializer component provides an adapter based interface to simply generate storable representation of PHP types by different facilities, and recover.
For more information what a serializer is read the wikipedia page of Serialization.
Quick Start¶
Serializing adapters can either be created from the provided Zend\Serializer\Serializer::factory method, or by simply instantiating one of the Zend\Serializer\Adapter\* classes.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | use Zend\Serializer\Serializer;
// Via factory:
$serializer = Zend\Serializer\Serializer::factory('PhpSerialize');
// Alternately:
$serializer = new Zend\Serializer\Adapter\PhpSerialize();
// Now $serializer is an instance of Zend\Serializer\Adapter\AdapterInterface,
// specifically Zend\Serializer\Adapter\PhpSerialize
try {
$serialized = $serializer->serialize($data);
// now $serialized is a string
$unserialized = $serializer->unserialize($serialized);
// now $data == $unserialized
} catch (Zend\Serializer\Exception\ExceptionInterface $e) {
echo $e;
}
|
The method serialize() generates a storable string. To regenerate this serialized data you can simply call the method unserialize().
Any time an error is encountered serializing or unserializing, Zend\Serializer will throw a Zend\Serializer\Exception\ExceptionInterface.
Because of an application often uses internally only one serializer it is possible to define and use a default serializer. That serializer will be used by default by other components like Zend\Cache\Storage\Plugin\Serializer.
To use the default serializer you can simply use the static serialization methods of the basic Zend\Serializer\Serializer:
1 2 3 4 5 6 7 8 9 10 11 | use Zend\Serializer\Serializer;
try {
$serialized = Serializer::serialize($data);
// now $serialized is a string
$unserialized = Serializer::unserialize($serialized);
// now $data == $unserialized
} catch (Zend\Serializer\Exception\ExceptionInterface $e) {
echo $e;
}
|
Basic configuration Options¶
To configure a serializer adapter, you can optionally use an instance of Zend\Serializer\Adapter\AdapterOptions, an instance of one of the adapter specific options class, an array or an instance of Traversable. The adapter will convert it into the adapter specific options class instance (if present) or into the basic Zend\Serializer\Adapter\AdapterOptions class instance.
Options can be passed as second argument to the provided Zend\Serializer\Serializer::factory method, using the method setOptions or set as constructor argument.
Available Methods¶
Each serializer implements the interface Zend\Serializer\Adapter\AdapterInterface.
This interface defines the following methods:
- serialize(mixed $value)
Generates a storable representation of a value.
Return type: string
- unserialize(string $value)
Creates a PHP value from a stored representation.
Return type: mixed
The basic class Zend\Serializer\Serializer will be used to instantiate the adapters, to configure the factory and to handle static serializing.
It defines the following static methods:
- factory(string|Zend\Serializer\Adapter\AdapterInterface $adapterName, Zend\Serializer\Adapter\AdapterOptions|array|Traversable|null $adapterOptions = null)
Create a serializer adapter instance.
Return type: Zend\Serializer\Adapter\AdapterInterface
- setAdapterPluginManager(Zend\Serializer\AdapterPluginManager $adapters)
Change the adapter plugin manager.
Return type: void
- getAdapterPluginManager()
Get the adapter plugin manager.
Return type: Zend\Serializer\AdapterPluginManager
- resetAdapterPluginManager()
Resets the internal adapter plugin manager.
Return type: void
- setDefaultAdapter(string|Zend\Serializer\Adapter\AdapterInterface $adapter, Zend\Serializer\Adapter\AdapterOptions|array|Traversable|null $adapterOptions = null)
Change the default adapter.
Return type: void
- getDefaultAdapter()
Get the default adapter.
Return type: Zend\Serializer\Adapter\AdapterInterface
- serialize(mixed $value, string|Zend\Serializer\Adapter\AdapterInterface|null $adapter = null, Zend\Serializer\Adapter\AdapterOptions|array|Traversable|null $adapterOptions = null)
Generates a storable representation of a value using the default adapter. Optionally different adapter could be provided as second argument.
Return type: string
- unserialize(string $value, string|Zend\Serializer\Adapter\AdapterInterface|null $adapter = null, Zend\Serializer\Adapter\AdapterOptions|array|Traversable|null $adapterOptions = null)
Creates a PHP value from a stored representation using the default adapter. Optionally different adapter could be provided as second argument.
Return type: mixed