PHPackages jsanbae/metamorphoser - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jsanbae/metamorphoser ActiveLibrary[Utility & Helpers](/categories/utility) jsanbae/metamorphoser ===================== Procesa tus arrays en diferentes etapas 1.1.6(4y ago)138MITPHPPHP ^7.3|^8.0 Since May 19Pushed 4y ago1 watchersCompare [ Source](https://github.com/jsanbae/metamorphoser)[ Packagist](https://packagist.org/packages/jsanbae/metamorphoser)[ RSS](/packages/jsanbae-metamorphoser/feed)WikiDiscussions master Synced 1w ago READMEChangelog (6)Dependencies (2)Versions (8)Used By (0) [![Travis (.org)](https://camo.githubusercontent.com/312b21c4cb2332c04c492304a958eb15f29fe411a3af60d68e1e55d4cbbd947a/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6a73616e353730392f6d6574616d6f7270686f736572)](https://camo.githubusercontent.com/312b21c4cb2332c04c492304a958eb15f29fe411a3af60d68e1e55d4cbbd947a/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6a73616e353730392f6d6574616d6f7270686f736572) [![GitHub issues](https://camo.githubusercontent.com/43137213e35c940c5ca50096fa8a2e074f0ed9bc542e051d180f6ae360d1bd0d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a73616e353730392f6d6574616d6f7270686f736572)](https://camo.githubusercontent.com/43137213e35c940c5ca50096fa8a2e074f0ed9bc542e051d180f6ae360d1bd0d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a73616e353730392f6d6574616d6f7270686f736572) [![GitHub](https://camo.githubusercontent.com/e7a617d3225446394d4d51a4faff4f6cb2d8b6b977117117f977bd552a8db03d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a73616e353730392f6d6574616d6f7270686f736572)](https://camo.githubusercontent.com/e7a617d3225446394d4d51a4faff4f6cb2d8b6b977117117f977bd552a8db03d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a73616e353730392f6d6574616d6f7270686f736572) Metamorphoser 🐛 🦋 ================= [](#metamorphoser-bug-butterfly) Es un librería diseñada para manipular arreglos asociativos (associative arrays) en varias etapas. Aunque el principal uso que le doy es para procesar linea por linea archivos CSV. Instalación ----------- [](#instalación) Metamorphoser es compatible y testeado en PHP 7.3 y superiores. Esta librería puede ser instalada a través de [composer](https://www.getcomposer.org) usando el siguiente comando: ``` composer require jsanbae/metamorphoser ``` Partes del Metamorphoser ------------------------ [](#partes-del-metamorphoser) ### Metamorphoser [](#metamorphoser) Órgano encargado de orquestar el orden los Pipes(etapas) para la metamorfosis y entregar los datos "metamorfoseados", como así también los datos con errores y lo datos filtrados. ### Dataset [](#dataset) Entidad atómica en la cual se encapsula los datos, estructura necesaria para ser procesada dentro de la metamorfosis. ### Pipes [](#pipes) Órganos encargados de procesar los dataset. Se han definido 4 tipos, sin embargo, puedes crear los que tu quieras. #### Arranger [](#arranger) Pipe encargada de dar estructura definida a lo datos #### Mutator [](#mutator) Pipe encargada de modificar(formatear, limpiar, etc) la información. #### Validator [](#validator) Pipe encargada de validar la información, determina si información tiene errores. Colecciona los errores de la información. #### Filter [](#filter) Pipe encargada de quitar la información, mediante filtros. Ejemplo de uso -------------- [](#ejemplo-de-uso) Favor ver archivos en directorio ./example Laravel Friendly 😘 ------------------ [](#laravel-friendly-kissing_heart) Si bien es una librería que no tiene dependencia directa con [Laravel Framework](https://laravel.com) puedes integrarla sin problemas en tus proyectos Laravel, con el siguiente comando: ``` php artisan make:metamorphoser myMetamorphoser ``` El comando creará los siguientes archivos base: ``` - app -- Metamorphosers --- myMorpher.php --- Arrangers ---- MyArranger.php --- Mutators ---- MyMutator.php --- Validators ---- MyValidator.php --- Filters ---- MyFilter.php ``` Implementado sería: ``` use App\Metamorphosers\myMorpher; .... $metamorposer = new myMorpher(); $metamorposer->morph($data); //o desde un archivo $file_path = "/mydir/data.csv"; $separator = ";"; $metamorposer->morphFromCSV($file_path, $separator); ``` Salida: ``` //Output array(3) => ["data"] => ['data processed'] ["errors"] => ['data errors'] ["filtered"] => ['data filtered'] ``` Contribución ------------ [](#contribución) Es librería sencilla hecha con amor ❤️, pero se que puede mejorar con contribuciones de quienes la usen. Sugiere tus propias mejoras, te invito a discutirlas en "Issues" antes de enviar tus "Pull Requests". Los "Pull requests" para bugs siempre son bienvenidos, por favor explica tu bug que estás intentando corregir en el mensaje. Hay sólo algunas pruebas unitarias en el PHPUnit. Sería genial tener más tests para obtener mayor cobertura en otros casos. Sientete libre en contribuir con eso. Disclaimer ---------- [](#disclaimer) No se me ocurrió otro nombre más rebuscado para esta librería (y puta que lo pensé) ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~29 days Recently: every ~38 days Total 7 Last Release 1648d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5470429?v=4)[Javier Sánchez Baeza](/maintainers/jsanbae)[@jsanbae](https://github.com/jsanbae) --- Top Contributors [![jsanbae](https://avatars.githubusercontent.com/u/5470429?v=4)](https://github.com/jsanbae "jsanbae (17 commits)") --- Tags arrayarray-manipulationscsvlaravelphparrayprocesscsvcollections ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jsanbae-metamorphoser/health.svg) ``` [![Health](https://phpackages.com/badges/jsanbae-metamorphoser/health.svg)](https://phpackages.com/packages/jsanbae-metamorphoser) ``` ### Alternatives [doctrine/collections PHP Doctrine Collections library that adds additional functionality on top of PHP arrays. 6.0k411.1M1.2k](/packages/doctrine-collections)[malarzm/collections Various implementations of Doctrine's Collection interface 2368.1k](/packages/malarzm-collections)[vistik/typed-collections A simple way to create typed collections in PHP - build on Illuminate\\Support\\Collection 1128.2k5](/packages/vistik-typed-collections)[rotexsoft/versatile-collections A collection package that can be extended to implement things such as a Dependency Injection Container, RecordSet objects for housing database records, a bag of http cookies, or technically any collection of items that can be looped over and whose items can each be accessed using array-access syntax or object property syntax. 186.0k1](/packages/rotexsoft-versatile-collections) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)