39 lines
1.0 KiB
PHP
39 lines
1.0 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\Cache\Marshaller;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Serializes/unserializes PHP values.
|
||
|
|
*
|
||
|
|
* Implementations of this interface MUST deal with errors carefully. They MUST
|
||
|
|
* also deal with forward and backward compatibility at the storage format level.
|
||
|
|
*
|
||
|
|
* @author Nicolas Grekas <p@tchwork.com>
|
||
|
|
*/
|
||
|
|
interface MarshallerInterface
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* Serializes a list of values.
|
||
|
|
*
|
||
|
|
* When serialization fails for a specific value, no exception should be
|
||
|
|
* thrown. Instead, its key should be listed in $failed.
|
||
|
|
*/
|
||
|
|
public function marshall(array $values, ?array &$failed): array;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Unserializes a single value and throws an exception if anything goes wrong.
|
||
|
|
*
|
||
|
|
* @throws \Exception Whenever unserialization fails
|
||
|
|
*/
|
||
|
|
public function unmarshall(string $value): mixed;
|
||
|
|
}
|