Serializer
class Serializer implements SerializerInterface, NormalizerInterface, DenormalizerInterface, EncoderInterface, DecoderInterface
Serializer serializes and deserializes data.
objects are turned into arrays by normalizers. arrays are turned into various output formats by encoders.
$serializer->serialize($obj, 'xml') $serializer->decode($data, 'xml') $serializer->denormalize($data, 'Class', 'xml')
Methods
__construct(array $normalizers = array(), array $encoders = array()) | ||
string | serialize(mixed $data, string $format, array $context = array()) Serializes data in the appropriate format. | |
object | deserialize(mixed $data, string $type, string $format, array $context = array()) Deserializes data into the given type. | |
array|scalar | normalize($data, string $format = null, array $context = array()) Normalizes an object into a set of arrays/scalars. | |
object | denormalize(mixed $data, $type, string $format = null, array $context = array()) Denormalizes data back into an object of the given class. | |
bool | supportsNormalization(mixed $data, string $format = null) Checks whether the given class is supported for normalization by this normalizer. | |
bool | supportsDenormalization(mixed $data, string $type, string $format = null) Checks whether the given class is supported for denormalization by this normalizer. | |
scalar | encode(mixed $data, string $format, array $context = array()) Encodes data into the given format. | |
mixed | decode(string $data, string $format, array $context = array()) Decodes a string into PHP data. | |
bool | supportsEncoding(string $format) Checks whether the serializer can encode to given format. | |
bool | supportsDecoding(string $format) Checks whether the deserializer can decode from given format. |
Details
__construct(array $normalizers = array(), array $encoders = array())
Parameters
array | $normalizers | |
array | $encoders |
final string serialize(mixed $data, string $format, array $context = array())
Serializes data in the appropriate format.
Parameters
mixed | $data | any data |
string | $format | format name |
array | $context | options normalizers/encoders have access to |
Return Value
string |
final object deserialize(mixed $data, string $type, string $format, array $context = array())
Deserializes data into the given type.
Parameters
mixed | $data | |
string | $type | |
string | $format | |
array | $context |
Return Value
object |
array|scalar normalize($data, string $format = null, array $context = array())
Normalizes an object into a set of arrays/scalars.
Parameters
$data | ||
string | $format | format the normalization result will be encoded as |
array | $context | Context options for the normalizer |
Return Value
array|scalar |
object denormalize(mixed $data, $type, string $format = null, array $context = array())
Denormalizes data back into an object of the given class.
Parameters
mixed | $data | data to restore |
$type | ||
string | $format | format the given data was extracted from |
array | $context | options available to the denormalizer |
Return Value
object |
bool supportsNormalization(mixed $data, string $format = null)
Checks whether the given class is supported for normalization by this normalizer.
Parameters
mixed | $data | Data to normalize |
string | $format | The format being (de-)serialized from or into |
Return Value
bool |
bool supportsDenormalization(mixed $data, string $type, string $format = null)
Checks whether the given class is supported for denormalization by this normalizer.
Parameters
mixed | $data | Data to denormalize from |
string | $type | The class to which the data should be denormalized |
string | $format | The format being deserialized from |
Return Value
bool |
final scalar encode(mixed $data, string $format, array $context = array())
Encodes data into the given format.
Parameters
mixed | $data | Data to encode |
string | $format | Format name |
array | $context | options that normalizers/encoders have access to |
Return Value
scalar |
Exceptions
UnexpectedValueException |
final mixed decode(string $data, string $format, array $context = array())
Decodes a string into PHP data.
Parameters
string | $data | Data to decode |
string | $format | Format name |
array | $context | options that decoders have access to The format parameter specifies which format the data is in; valid values depend on the specific implementation. Authors implementing this interface are encouraged to document which formats they support in a non-inherited phpdoc comment. |
Return Value
mixed |
Exceptions
UnexpectedValueException |
bool supportsEncoding(string $format)
Checks whether the serializer can encode to given format.
Parameters
string | $format | format name |
Return Value
bool |
bool supportsDecoding(string $format)
Checks whether the deserializer can decode from given format.
Parameters
string | $format | format name |
Return Value
bool |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Serializer/Serializer.html