Constructor

The constructor middleware uses reflection to register a custom factory to the factory registry which can utilise the class constructor. This enables the use of custom constructors without having to manually write factories. This feature can be combined with the readonly properties introduced with PHP 8.1.

Available since JsonMapper 2.14.0

class User
{
    public function __construct(
        public readonly string $name,
    ) {}
}
 
$factoryRegistry = new \JsonMapper\Handler\FactoryRegistry();
$mapper = \JsonMapper\JsonMapperBuilder::new()
    ->withDocBlockAnnotationsMiddleware()
    ->withObjectConstructorMiddleware($factoryRegistry)
    ->withPropertyMapper(new \JsonMapper\Handler\PropertyMapper($factoryRegistry))
    ->build();
 
$object = $mapper->mapToClassFromString('{ "name": "John Doe" }', User::class);
 
echo $object->name; // "John Doe"