boulzy / data-transformer
Transform objects into other objects
Requires
- php: ^8.3
- phpdocumentor/reflection-docblock: ^5.3
- symfony/property-access: ^7.0
- symfony/property-info: ^7.0
Requires (Dev)
- doctrine/common: ^3.4
- friendsofphp/php-cs-fixer: ^3.49
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^10.5
- symfony/config: ^7.0
- symfony/dependency-injection: ^7.0
- symfony/http-kernel: ^7.0
- symfony/var-dumper: ^7.0
This package is auto-updated.
Last update: 2024-10-24 02:16:49 UTC
README
The boulzy/data-transformer library provides a simple and flexible way to transform objects into other objects.
📋 Table of contents
👋 Introduction
When manipulating data, the need to change the representation of this data sometimes arises, so it can be used by the different components of the application. A common example is the need to transform DTOs to business objects and vice versa.
This transformation often involves a lot of boilerplate code that is not directly related to the business logic of the application. This library aims to reduce the repetition of this code by providing a simple and flexible way to transform an object into an object of another class.
⚙️ Requirements
- PHP ^8.3
- symfony/property-access ^7.0
- symfony/property-info ^7.0
- phpdocumentor/reflection-docblock ^5.3
ℹ️ This library also provides a bundle to use and extend the DataTransformer in a Symfony application.
📚 Documentation
The documentation is available in the docs/
directory of this repository.
⬇️ Installation
The installation is done using Composer.
composer require boulzy/data-transformer
Don't forget to include vendor/autoload.php
file.
🧑💻 Usage
First, you must retrieve an instance of \Boulzy\DataTransfomer\DataTransformerInterface
.
If you're not in a Symfony application, check the documentation to learn how to get a DataTransformer object.
The DataTransformer exposes one method: transform(object $source, string $targetClass): object
. The first argument is
the object you currently have, and the second the class in which you want to transform it.
<?php
namespace App\Controller;
use App\DTO\EditUser;
use App\Entity\User;
use Boulzy\DataTransformer\DataTransformerInterface;
use Doctrine\Persistence\ObjectManager;
use Symfony\Component\HttpKernel\Exception\UnprocessableEntityHttpException;
use Symfony\Component\Validator\Validator\ValidatorInterface;
class UserController
{
public function __construct(
private ValidatorInterface $validator,
private DataTransformerInterface $transformer,
private ObjectManager $manager,
) {
}
public function __invoke(EditUser $editUser): User
{
$errors = $this->validator->validate($editUser);
if (0 < \count($errors)) {
throw new UnprocessableEntityHttpException((string) $errors);
}
$user = $this->transformer->transform($editUser, User::class);
$this->manager->flush();
return $user;
}
}
Ready for more? Let's get started! 🚀