53 lines
1.9 KiB
PHP
53 lines
1.9 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
/*
|
||
|
|
* This file is part of the Symfony package.
|
||
|
|
*
|
||
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
||
|
|
*
|
||
|
|
* For the full copyright and license information, please view the LICENSE
|
||
|
|
* file that was distributed with this source code.
|
||
|
|
*/
|
||
|
|
|
||
|
|
namespace Symfony\Component\Serializer;
|
||
|
|
|
||
|
|
use Symfony\Component\Serializer\Exception\ExceptionInterface;
|
||
|
|
use Symfony\Component\Serializer\Exception\NotNormalizableValueException;
|
||
|
|
use Symfony\Component\Serializer\Exception\UnexpectedValueException;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @author Jordi Boggiano <j.boggiano@seld.be>
|
||
|
|
*/
|
||
|
|
interface SerializerInterface
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* Serializes data in the appropriate format.
|
||
|
|
*
|
||
|
|
* @param array<string, mixed> $context Options normalizers/encoders have access to
|
||
|
|
*
|
||
|
|
* @throws NotNormalizableValueException Occurs when a value cannot be normalized
|
||
|
|
* @throws UnexpectedValueException Occurs when a value cannot be encoded
|
||
|
|
* @throws ExceptionInterface Occurs for all the other cases of serialization-related errors
|
||
|
|
*/
|
||
|
|
public function serialize(mixed $data, string $format, array $context = []): string;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Deserializes data into the given type.
|
||
|
|
*
|
||
|
|
* @template TObject of object
|
||
|
|
* @template TType of string|class-string<TObject>
|
||
|
|
*
|
||
|
|
* @param TType $type
|
||
|
|
* @param array<string, mixed> $context
|
||
|
|
*
|
||
|
|
* @phpstan-return ($type is class-string<TObject> ? TObject : mixed)
|
||
|
|
*
|
||
|
|
* @psalm-return (TType is class-string<TObject> ? TObject : mixed)
|
||
|
|
*
|
||
|
|
* @throws NotNormalizableValueException Occurs when a value cannot be denormalized
|
||
|
|
* @throws UnexpectedValueException Occurs when a value cannot be decoded
|
||
|
|
* @throws ExceptionInterface Occurs for all the other cases of serialization-related errors
|
||
|
|
*/
|
||
|
|
public function deserialize(mixed $data, string $type, string $format, array $context = []): mixed;
|
||
|
|
}
|