PHPackages comhon-project/laravel-morphed-model-exporter - 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. [API Development](/categories/api) 4. / 5. comhon-project/laravel-morphed-model-exporter ActiveLibrary[API Development](/categories/api) comhon-project/laravel-morphed-model-exporter ============================================= A laravel library that permit to export morphed models through an API v1.2.0(10mo ago)0167[3 PRs](https://github.com/comhon-project/laravel-morphed-model-exporter/pulls)MITPHPPHP ^8.2CI passing Since May 15Pushed 3w ago1 watchersCompare [ Source](https://github.com/comhon-project/laravel-morphed-model-exporter)[ Packagist](https://packagist.org/packages/comhon-project/laravel-morphed-model-exporter)[ Docs](https://github.com/comhon-project/laravel-morphed-model-exporter)[ RSS](/packages/comhon-project-laravel-morphed-model-exporter/feed)WikiDiscussions main Synced today READMEChangelog (5)Dependencies (10)Versions (13)Used By (0) Laravel Morphed Model Exporter ============================== [](#laravel-morphed-model-exporter) [![Latest Version on Packagist](https://camo.githubusercontent.com/787dbb9ef3fbe7e43585458e73b84f80799f0740375612c65c9a6d0ae01927ec/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f6d686f6e2d70726f6a6563742f6c61726176656c2d6d6f72706865642d6d6f64656c2d6578706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/comhon-project/laravel-morphed-model-exporter)[![GitHub Tests Action Status](https://camo.githubusercontent.com/ac1512a747ff59ff4461d62512764b32db5b1d227a0bf7447bafa907ef7dfc32/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f6d686f6e2d70726f6a6563742f6c61726176656c2d6d6f72706865642d6d6f64656c2d6578706f727465722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/comhon-project/laravel-morphed-model-exporter/actions?query=workflow%3Arun-tests+branch%3Amain)[![Code Coverage](https://camo.githubusercontent.com/777f32d1026dd8f7a57f2c3cb10ea1da08c2ca45300209b65a98e1b0d93718b5/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f636f6d686f6e2d70726f6a6563742f6c61726176656c2d6d6f72706865642d6d6f64656c2d6578706f727465723f6c6162656c3d636f766572616765267374796c653d666c61742d737175617265)](https://codecov.io/gh/comhon-project/laravel-morphed-model-exporter)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/b2efd744cfbd620b89722557e66bf53b207d195ba2e95845facceeff532532c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f6d686f6e2d70726f6a6563742f6c61726176656c2d6d6f72706865642d6d6f64656c2d6578706f727465722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/comhon-project/laravel-morphed-model-exporter/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/ad76d95141c7c223f6b5e475a0b01a6ecf3fef36d29212e444cf4e9b34198a87/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6d686f6e2d70726f6a6563742f6c61726176656c2d6d6f72706865642d6d6f64656c2d6578706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/comhon-project/laravel-morphed-model-exporter) This library allows exporting morphed models (typically via an API). A morphed model is one that is loaded through a `MorphTo` relationship. Since these models belong to different classes, loading them from a collection along with their dependencies and exporting them can be cumbersome. This library makes it easy! Installation ------------ [](#installation) You can install the package via composer: ``` composer require comhon-project/laravel-morphed-model-exporter ``` Usage ----- [](#usage) ### Register exporters [](#register-exporters) In order to be able to export morphed models, you must define morphed model exporters. To do so, you must define a class with an `__invoke()` method that will return an array of exporters. Each key must be a eloquent model class and each value must be an array. Each array value must/may contain: - the key `model_exporter` (required). The associated value must be either a Closure and return the exported model (the eloquent model is inject as parameter) either a JsonResource class. - the key `query_builder` (optional). The associated value must be a Closure that will build the query given in parameter. ``` class MyMorphedModelsExporters { public function __invoke() { return [ FirstModel::class => [ 'query_builder' => fn ($query) => $query->with('dependency')->select('id', 'dependency_id'), 'model_exporter' => fn ($model) => $model->toArray(), ], SecondModel::class => [ 'model_exporter' => SecondModel::class, ], ] } } ``` Then you will have to register it in your `AppServiceProvider` like this : ``` public function register(): void { $this->app->bind('morphed-model-exporters', MyMorphedModelsExporters::class); } ``` Note: Your morphed model exporters class may also type-hint any dependencies they need on their constructors. This class is resolved via the Laravel service container, so dependencies will be injected automatically. ### Load morphed models [](#load-morphed-models) You should typically load morphed models in Controllers : ``` use Comhon\MorphedModelExporter\Facades\MorphedModelExporter; MorphedModelExporter::loadMorphedModels($myModels, 'myMorphToRelation'); ``` You can use additional parameters to customize query according a certain context : ``` class MyMorphedModelsExporters { public function __invoke() { return [ FirstModel::class => [ 'query_builder' => fn ($query, $columns = []) => $query->select([ 'id', 'dependency_id', ...$columns ]), ], ] } } ``` ``` use Comhon\MorphedModelExporter\Facades\MorphedModelExporter; MorphedModelExporter::loadMorphedModels($myModels, 'myMorphToRelation', ['my_column']); ``` ### Export morphed models [](#export-morphed-models) You should typically export morphed models in API resources : ``` use Comhon\MorphedModelExporter\Facades\MorphedModelExporter; 'my_morph_to_relation' => $this->whenLoaded( 'myMorphToRelation', fn ($morphedModel) => MorphedModelExporter::exportModel($morphedModel) ), ``` You can use additional parameters to customize export according a certain context : ``` class MyMorphedModelsExporters { public function __invoke() { return [ FirstModel::class => [ 'model_exporter' => fn ($model, $exportPrivate = false) => $exportPrivate ? ['id' => $model->id, 'private' => $model->is_private] : ['id' => $model->id], ], ] } } ``` ``` use Comhon\MorphedModelExporter\Facades\MorphedModelExporter; $exportPrivate = true; MorphedModelExporter::exportModel($morphedModel, $exportPrivate); ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [jean-philippe](https://github.com/comhon-project) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 42 — FairBetter than 88% of packages Maintenance77 Regular maintenance activity Popularity12 Limited adoption so far Community11 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 ~24 days Total 5 Last Release 318d ago PHP version history (2 changes)v1.0.0PHP ^8.3 v1.0.1PHP ^8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5593767?v=4)[Jan Štěpán](/maintainers/comhon)[@comhon](https://github.com/comhon) --- Top Contributors [![comhon-project](https://avatars.githubusercontent.com/u/14244177?v=4)](https://github.com/comhon-project "comhon-project (4 commits)")[![jeanphilippe-exatech](https://avatars.githubusercontent.com/u/247553054?v=4)](https://github.com/jeanphilippe-exatech "jeanphilippe-exatech (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags laravelcomhon-projectlaravel-morphed-model-exporter ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/comhon-project-laravel-morphed-model-exporter/health.svg) ``` [![Health](https://phpackages.com/badges/comhon-project-laravel-morphed-model-exporter/health.svg)](https://phpackages.com/packages/comhon-project-laravel-morphed-model-exporter) ``` ### Alternatives [dedoc/scramble Automatic generation of API documentation for Laravel applications. 2.1k11.2M101](/packages/dedoc-scramble)[defstudio/telegraph A laravel facade to interact with Telegram Bots 816333.9k3](/packages/defstudio-telegraph)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[neuron-core/neuron-laravel Official Neuron AI Laravel SDK. 11337.8k1](/packages/neuron-core-neuron-laravel)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.0k](/packages/simplestats-io-laravel-client)[lettermint/lettermint-laravel Official Lettermint driver for Laravel 1190.2k1](/packages/lettermint-lettermint-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)