mutator.md

Mutator

The mutator allows you to configure how to set a property.

Example

In this example, we configure the username property to use the setUsername method when de-serializing.

namespace Acme;

use Ivory\Serializer\Mapping\Annotation as Serializer;

class User
{
    /**
     * @Serializer\Mutator("setUsername")
     *
     * @var string
     */
    public $username;
    
    /**
     * @return string
     */
    public function setUsername($username)
    {
        $this->username = strtolower($username);
    }
}

Usage

use Acme\User;

$user = new User();
$user->username = 'GeLo';

$serialize = $serializer->serialize($user, $format);
// echo $serialize;

$deserialize = $serializer->deserialize($serialize, User::class, $format);
// $deserialize->username === 'gelo'

Definitions

If you prefer use an other definition format, the following examples are identical.

XML

<?xml version="1.0" encoding="UTF-8" ?>

<serializer
    xmlns="http://egeloen.fr/schema/ivory-serializer"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://egeloen.fr/schema/ivory-serializer
                        http://egeloen.fr/schema/ivory-serializer/mapping-1.0.xsd"
>
    <class name="Acme\User">
        <property name="username" mutator="setUsername" />
    </class>
</serializer>

YAML

Acme\User:
    properties:
        username:
            mutator: setUsername

JSON

{
    "Acme\\User": {
        "properties": {
            "username": {
                "mutator": "setUsername"
            }
        }
    }
}