liip / serializer-jms-adapter
Adapter to use liip/serializer in place of jms/serializer.
Installs: 134 163
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 12
Forks: 2
Open Issues: 0
Requires
- php: ^8.0
- ext-json: *
- jms/serializer: ^2.0||^3.0
- liip/serializer: ^1.0 || ^2.0
- pnz/json-exception: ^1.0
- psr/log: ^1 | ^2 | ^3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.20.0
- phpstan/phpstan: ^1.2
- phpstan/phpstan-phpunit: ^1.0
- phpunit/phpunit: ^8.5.29 || ^9.5.23
README
An adapter to make liip/serializer a drop-in replacement for jms/serializer.
Version 1 of this adapter is for integrating JMS Serializer version 1, and version 2 for JMS Serializer version 2 and 3. (Because there are BC breaks in the interfaces of JMS serializer that prevent this library from supporting JMS 1 and 2/3 with the same code.)
This library provides a serializer that attempts to use the Liip Serializer and
falls back to JMS serializer on error. You need to use the
Liip\Serializer\Adapter\JMS\AdapterSerializationContext
provided in this
library instead of the regular JMS\Serializer\SerializationContext
. You can
use the Serializer\Adapter\JMS\AdapterSerializationContextFactory
when
working with libraries that create the context themselves.
Usage
use JMS\Serializer\Serializer as JMSSerializer; use Liip\Serializer\Adapter\JMS\JMSSerializerAdapter; use Liip\Serializer\Serializer as LiipSerializer; // see https://github.com/liip/serializer/ for how to set up the Liip Serializer $liipSerializer = new LiipSerializer(...); // see https://jmsyst.com/libs/serializer for how to set up JMS Serializer $jmsSerializer = new JMSSerializer(...); $serializer = new JMSSerializerAdapter($liipSerializer, $jmsSerializer, new NullLogger()); // $serializer can now be used in place of $jmsSerializer
Using Liip Serializer only for a Subset of Models
The JMSSerializerAdapter
accepts an additional constructor argument to specify
a list of enabled classes. If that list is specified, only those classes will
be attempted to handle with the Liip Serializer. If you want to use JMS
Serializer for some of your models and the Liip Serializer for others, use this
configuration to avoid overhead and avoid warning log entries from the adapter
that you do not care about.
$enabledClasses = ['App\Model\Product', 'App\Model\Category']; $serializer = new JMSSerializerAdapter($liipSerializer, $jmsSerializer, new NullLogger(), $enabledClasses);