alexpts / php-data-transformer2 Goto Github PK

Добавить в папку example примеры использования:

• ref модели 2-3 уровня глубины (показать, что весь граф можно просто преобразовать)
• добавление map без файла из папки
• переопределение defaultMapDir
• кейс с excludeFields

Pipe опция должна расширять гидратор, но не являться частью гидратора. Это дополнительная функциональность.
Вся дополнительная функциональность как раз в этом пакете сосредоточена.

Для более сложной логики в pipe обработчике могут потребоваться зависимости, которых нет в модели.

Конфиг описания карт уже перестал быть декларативным с появлением pipe. Нужно подумать, чтобы map, не возвращал массив с правилами, а имел внутри $mapper и работал с ним. В mapper добавить опционально контейнер. Тогда будет возможность в карте из контейнера получить любые зависимости и прокинуть их через замыкание в pipe обработчики.

Это позволит держать всю логику преобразований в 1 файле, она не будет размазываться по событиям, хоть это и сделает код более грязным и связанным, но это упростит для пользователя преобразования.

1 плоскую модель нужно представить в виде вложенной иерархии, как и обратное.
Подумать про атрибут target для карты трансформации.

Тоже самое сделать для преборазовании колекции в dto и из dto в модель

В phpStorm через конфигурацию в файле .phpstorm.meta.php можно научить автоподсветку делать возвращаемый тип из первого аргумента через такое правило:

override(\PTS\DataTransformer\DataTransformerInterface::toModel(0), map([
    "" => "@",
]));

Для этого нужно чтобы параметр, который описывает класс, который должен быть на выходе в декларации шел первым.

Нужно поменять аргументы во всех методах, переставив на 1 место класс модели, которую ожидаем на выходе. Это позволит в частных кейсах иметь автоматическую подстветку типа возвращаемого. Пример частного кейса:

$model = $this->mapper->toModel(SomeModel::class, $attributes);

Но некоторые кейсы по-прежнему придется вручную через phpDoc указывать типы:
$class = SomeModel::class; $model = $this->mapper->toModel($class, $attributes);