Download the PHP package spiral-packages/symfony-serializer without Composer

Symfony serializer bridge for Spiral Framework

This package provides an extension to the default list of serializers in Spiral Framework, allowing you to easily serialize and deserialize objects into various formats such as JSON, XML, CSV, and YAML.

Note Read more about spiral/serializer component in the official documentation.

If you are building a REST API or working with queues, this package will be especially useful as it allows you to use objects as payload instead of simple arrays.

This documentation will guide you through the installation process and provide examples of how to use the package to serialize and deserialize your objects.

Requirements

Make sure that your server is configured with following PHP version and extensions:

• PHP 8.1+
• Spiral framework ^3.7
• Symfony Serializer Component ^6.4 || ^7.0
• Symfony PropertyAccess Component ^6.4 || ^7.0

Installation

You can install the package via composer:

After package install you need to register bootloader from the package.

Note Bootloader Spiral\Serializer\Bootloader\SerializerBootloader can be removed. If you are using spiral-packages/discoverer, you don't need to register bootloader by yourself.

Configuration

The package comes with default configurations for normalizers, encoders, and metadataLoader. However, you can change these configurations based on your project's requirements.

There are two ways to configure the package:

Config file

You can create a configuration file app/config/symfony-serializer.php and define normalizers, encoders, and Symfony\Component\Serializer\Mapping\Loader\LoaderInterface for Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory used by the Symfony Serializer component parameters to extend the default configuration.

Here is an example of the configuration file:

Bootloader

Spiral\Serializer\Symfony\EncodersRegistryInterface and Spiral\Serializer\Symfony\NormalizersRegistryInterface provided by the package to add your own normalizers or encoders. You can register your own normalizers or encoders using the register method provided by these interfaces.

Here is an example:

Usage

The package provides a list of serializers that can be used to serialize and deserialize objects.

The serializers available in this package are: symfony-json, symfony-csv, symfony-xml, symfony-yaml.

Warning The yaml encoder requires the symfony/yaml package and is disabled when the package is not installed. Install the symfony/yaml package and the encoder will be automatically enabled.

Here are several ways to use these serializers:

1. Set a default serializer

You can set a desired Symfony serializer as the default application serializer by setting the DEFAULT_SERIALIZER_FORMAT environment variable.

Once the default serializer is set, you can request the Spiral\Serializer\SerializerInterface from the container and use it to serialize and deserialize objects.

Serialization:

Deserialization:

2. Using with the Serializer Manager

You can request a desired serializer from Spiral\Serializer\SerializerManager by its name. Once you have the serializer, you can use it to serialize and deserialize objects.

Serialization:

Deserialization:

Alternatively, you can use the serialize and unserialize methods of the manager class:

3. Using with Symfony Serializer

You can also use the Symfony Serializer directly by requesting the Symfony\Component\Serializer\SerializerInterface from the container. Once you have the serializer, you can use it to serialize and deserialize objects.

Here's an example:

Additional methods

Symfony Serializer Manager provides additional methods to work with data:

• normalize: This method takes in data and a format and returns a value that represents the normalized data. The context parameter can also be passed to control the normalization process.

• denormalize: This method takes in data, a type, a format, and a context, and returns an object that represents the denormalized data.

• supportsNormalization: This method takes in data, a format, and a context, and returns a boolean indicating whether the given data can be normalized by the serializer.

• supportsDenormalization: This method takes in data, a type, a format, and a context, and returns a boolean indicating whether the given data can be denormalized by the serializer.

• encode: This method takes in data, a format, and a context, and returns a string that represents the encoded data.

• decode: This method takes in data, a format, and a context, and returns a value that represents the decoded data.

• supportsEncoding: This method takes in a format and a context, and returns a boolean indicating whether the given format can be used to encode data by the serializer.

• supportsDecoding: This method takes in a format and a context, and returns a boolean indicating whether the given format can be used to decode data by the serializer.

These methods provide additional flexibility for working with different data formats and can be useful in certain scenarios.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.