{"id":21384948,"url":"https://github.com/alexpts/php-data-transformer","last_synced_at":"2025-06-24T20:06:13.913Z","repository":{"id":56944710,"uuid":"49263289","full_name":"alexpts/php-data-transformer","owner":"alexpts","description":"Transform model to data and back","archived":false,"fork":false,"pushed_at":"2020-06-09T19:41:21.000Z","size":62,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-06T11:06:32.185Z","etag":null,"topics":["data-mapper","dto","hydrator","transformer"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexpts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-08T09:35:04.000Z","updated_at":"2020-06-09T19:41:23.000Z","dependencies_parsed_at":"2022-08-21T07:50:53.742Z","dependency_job_id":null,"html_url":"https://github.com/alexpts/php-data-transformer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alexpts/php-data-transformer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpts%2Fphp-data-transformer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpts%2Fphp-data-transformer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpts%2Fphp-data-transformer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpts%2Fphp-data-transformer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexpts","download_url":"https://codeload.github.com/alexpts/php-data-transformer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpts%2Fphp-data-transformer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261749173,"owners_count":23203989,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-mapper","dto","hydrator","transformer"],"created_at":"2024-11-22T11:44:03.936Z","updated_at":"2025-06-24T20:06:13.891Z","avatar_url":"https://github.com/alexpts.png","language":"PHP","readme":"# php-data-transformer\n\n\u003e ## Repository abandoned 2019-12-31\n\u003e\n\u003e This repository has moved to [alexpts/php-data-transformer2](https://github.com/alexpts/php-data-transformer2).\n\n[![SensioLabsInsight](https://insight.sensiolabs.com/projects/de0407d9-12fe-4d3d-a688-9b29b10a0e46/big.png)](https://insight.sensiolabs.com/projects/de0407d9-12fe-4d3d-a688-9b29b10a0e46)\n\n[![Build Status](https://travis-ci.org/alexpts/php-data-transformer.svg?branch=master)](https://travis-ci.org/alexpts/php-data-transformer)\n[![Test Coverage](https://codeclimate.com/github/alexpts/php-data-transformer/badges/coverage.svg)](https://codeclimate.com/github/alexpts/php-data-transformer/coverage)\n[![Code Climate](https://codeclimate.com/github/alexpts/php-data-transformer/badges/gpa.svg)](https://codeclimate.com/github/alexpts/php-data-transformer)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/alexpts/php-data-transformer/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/alexpts/php-data-transformer/?branch=master)\n\n\nБолее новый и гибкий вариант библиотеки - https://github.com/alexpts/php-data-transformer2\n\nОдни и те же данные нужно представить в разном виде. В коде удобно работать с высокоуровневыми моделями. Но для сохранения этих данных в базу данных, как правило, данные требуется перевести в более простой вид, обычно в ассоциативный массив. Для передачи данных между приложениями используют простые DTO сущности.\n\nКомпонент позволяет легко конвертировать ваши данные в ассоциативный массив и обратно из массива в вашу модель.\n\nВся схема маппинга описывается декларативно и вне модели. Позволяя для одной и то же модели описать разные схемы маппинга и трансформации полей. Например поле типа `DateTime` перед сохренением в mongoDB удобно преобразовать в объект типа `MongoDate` или `UTCDateTime`. Перед отдачей клиенту преобразовать его в строку ISO8601. Перед сохранением в redis преобразовать в `timestamp`.\n\nДанные присланные из формы браузера всегда имеют стрковый тип данных, будь то числа или `true/false`. Трансформер решает эту проблему, в моделе данные всегда будут перобразованны в тип, указанный в карте трансформации.\n\n#### Installation\n\n```$ composer require alexpts/php-data-transformer```\n\n#### Требования\nPHP 7.0+\n\n#### Модели\nТрансформатор никак не ограничивает ваши модели. Вы работаете с чистыми моделями.\n\n#### Трансформеры\nПри трансформации модели в массив или массива в модель каждое поле проходит через определнный тип в карте трансформации.\nКарта трансформации представляет собой yml файл вида:\n```yml\nid:\n    type: int\n    get: getId\nlogin:\n    type: string\n    get: getLogin\n    set: setLogin\nname:\n    type: string\n    prop: name\nactive:\n    type: bool\n    prop: active\ncreAt:\n    type: date\n    get: getCreAt\nemail:\n    type: string\n    prop: email\npostsIds:\n\ttype: int\n\tcoll: true\nroles:\n    type: refModels\n    prop: roles\n    rel:\n        model: \\\\SomeNamespace\\\\Role\n        map: dto\n```\n\nГде ключ является индексом массива. \n\n`type` - тип трансформера\n\n`coll` - [optional] true|false является ли значение коллекцией\n\n`prop` - [optional] свойство модели\n\n`get` - [optional] метод геттер модели (`prop` игнорируется)\n\n`set` - [optional] метод сеттер модели (`prop` игнорируется)\n\n`rel` - [optional] объект описывающий связанную моделть\n\t\n`rel.model` - [optional] полный стр оковый путь класса связанной модели\n\n`rel.map` - [optional] имя карты трансформации вложенной модели [умолч.: 'dto']\n\n\n#### Менеджер карт трансформации\nДля регистрации карт трансформации используется метод `setMapDir` объекта типа `MapsManager`.\nПервый параметр - класс модели. Второй - директория с картами трансформации для этой модели. \n\n```php\n$mapsManager = new MapsManager(new Parser);\n$mapsManager = setMapDir(UserModel::class, __DIR__ . '/transformers');\n```\n\n#### Model to DTO\n\n```php\n$transformer = new DataTransformer(\n\tnew TypeConverter,\n\t$mapsManager,\n\tnew ModelClosure\n);\n```\n\nМодель передается первым параметром в метод `getData` трансформатора. Вторым параметром указывается имя карты трансформации для этой модели. (по умолчанию `dto`).\n\n```php\n$user = new User('name', 'login', 'email@gmail.com');\n$dtoUser = $transformer-\u003egetData($user, 'dto');\n```\n\nПуть файла трансформации в этом примере будет иметь вид:\n\n`__DIR__ . '/transformers/dto.yml'`.\n\n\n#### Data to model\nЧерез эту же карту транфсформации данные могут быть обратимо преобразованы назад в модель.\n```php\n$data = [\n\t'name' =\u003e 'name',\n\t'login' =\u003e 'login',\n\t'email' =\u003e 'email@gmail.com'\n];\n\n$model = $transformer-\u003ecreateModel(User::class);\n$transformer-\u003efillModel($data, $model, 'dto');\n```\n\n#### Значение как коллекция\nЕсли поле модели представлено колелкцией каких-либо значение, то можно прогнать каждое значение коллекции через тип трансформации и получить коллекцию трансформированных значений. Для этого укажите полю в карте трансформации флаг `coll: true`. Тоже самое можно сделать написав собственный тип трансформации, который сам решает как обработать значение-коллекцию.\n\n#### Вложенные модели\nВы можете описывать свои типы трансформации для вложенных моделей. Примером трансформации вложенной коллекции моделей служит тип `refModels`. [Пример трансформации модели с массивом вложенных моделей](https://github.com/alexpts/php-data-transformer/blob/master/example/refs/demo1.php).\n\nЗачастую передавать или хранить вместо вложенной модели разумно только ее id. Примером такой трансформации является тип `refModelsToArrayStringId`. Если id модели должен быть представлен не строковым типом (например `MongoId` или `ObjectId`), то просто опишите свой тип.\n\n#### Подключение собственного типа\nСоздайте свой тип трансформации с методами `toData` и `toModel`. Новый тип подключается к объекту типа `TypeConverter` методом `addType($name, $type)`. С помощью этого метода, можно перетереть стандатные типы, заместив их собтсвенной реализацией.\n\nМожно отнаследоваться от класса TypeConverter и указать в конуструкторе все дефолтные типы, чтобы не подключать типы вручную.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpts%2Fphp-data-transformer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexpts%2Fphp-data-transformer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpts%2Fphp-data-transformer/lists"}