PHPackages                             engageinteractive/laravel-view-models - 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. [Templating & Views](/categories/templating)
4. /
5. engageinteractive/laravel-view-models

ActiveLibrary[Templating & Views](/categories/templating)

engageinteractive/laravel-view-models
=====================================

Use view models instead of database model in your blade files and JSON responses.

2.0.2(6mo ago)212.6k↓50%MITPHPCI failing

Since Mar 29Pushed 6mo ago6 watchersCompare

[ Source](https://github.com/engageinteractive/laravel-view-models)[ Packagist](https://packagist.org/packages/engageinteractive/laravel-view-models)[ RSS](/packages/engageinteractive-laravel-view-models/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (16)Used By (0)

Laravel View Models
===================

[](#laravel-view-models)

[![Build Status](https://camo.githubusercontent.com/ec55960e056ba493b36cdf75aded3332e788b692a603494f26be54b2421d39de/68747470733a2f2f7472617669732d63692e6f72672f656e67616765696e7465726163746976652f6c61726176656c2d766965772d6d6f64656c732e737667)](https://travis-ci.org/engageinteractive/laravel-view-models)[![Total Downloads](https://camo.githubusercontent.com/c739542879d5aeed4de4a83aee0fc4c9c37069fab0cda622b8b6bb960ca75936/68747470733a2f2f706f7365722e707567782e6f72672f656e67616765696e7465726163746976652f6c61726176656c2d766965772d6d6f64656c732f642f746f74616c2e737667)](https://packagist.org/packages/engageinteractive/laravel-view-models)[![Latest Stable Version](https://camo.githubusercontent.com/03d25cb43353b7be891565c735c1941d82206b7fbed7d9cfaf8ae3850563768e/68747470733a2f2f706f7365722e707567782e6f72672f656e67616765696e7465726163746976652f6c61726176656c2d766965772d6d6f64656c732f762f737461626c652e737667)](https://packagist.org/packages/engageinteractive/laravel-view-models)[![License](https://camo.githubusercontent.com/3175a369368b208ec9a6d294f092012dc9aee6f10de680862a10184236fc0c66/68747470733a2f2f706f7365722e707567782e6f72672f656e67616765696e7465726163746976652f6c61726176656c2d766965772d6d6f64656c732f6c6963656e73652e737667)](https://packagist.org/packages/engageinteractive/laravel-view-models)

A straight forward pattern for using mappers/view models instead of database model in your blade files and JSON responses.

Installation
------------

[](#installation)

```
composer require engageinteractive/laravel-view-models
```

Mappers
-------

[](#mappers)

Create a mapper that can build view models for your Eloquent model:

```
namespace App\Domain\Posts;

use EngageInteractive\LaravelViewModels\Mapper;

use App\Domain\Posts\Post;

class PostShowMapper extends Mapper
{
    /**
     * Map a Post to a basic PHP array.
     *
     * @param \App\Domain\Posts\Post
     * @return array
     */
    public function map(Post $post)
    {
        return $post->only('title', 'author_name');
    }
}
```

Ask for an instance of the Mapper in your controller via the container:

```
namespace App\Domain\Posts;

use App\Domain\Posts\Post;
use App\Domain\Posts\PostMapper;
use App\Http\Controllers\Controller;

class PostController extends Controller
{
    /**
     * Show a Post.
     *
     * @param \App\Domain\Posts\Post
     * @param \App\Domain\Posts\PostMapper
     * @return \Illuminate\Views\View
     */
    public function show(Post $post, PostShowMapper $model)
    {
        return view('post.show', [
            'model' => $mapper->one($post),
        ]),
    }
}
```

View models
-----------

[](#view-models)

Create a view model, to build data to pass into your view:

```
namespace App\Domain\Posts;

use EngageInteractive\LaravelViewModels\ViewModel;
use Illuminate\Support\Str;

class PostViewModel extends ViewModel
{
    protected $post;

    /**
     * Intialise the View ViewModel.
     *
     * @param \App\Domain\Posts\Post
     * @return void
     */
    public function __construct(Post $post): void
    {
        $this->post = $post;
    }

    /**
     * Returns the post title in title-case.
     *
     * @return string
     */
    public function postTitle(): string
    {
        if (!isset($this->post->title)) {
            return 'Untitled';
        }

        return Str::title($this->post->title);
    }
}
```

Pass the ViewModel array into the view:

```
namespace App\Domain\Posts;

use App\Domain\Posts\Post;
use App\Domain\Posts\PostViewModel;
use App\Http\Controllers\Controller;

class PostController extends Controller
{
    /**
     * Show a Post.
     *
     * @param \App\Domain\Posts\Post
     * @return \Illuminate\Views\View
     */
    public function show(Post $post)
    {
        $model = new PostViewModel($post);

        return view('post.show', $model->array()),
    }
}
```

Below is an example of the data passed into the view:

```
[
    'model' => [
        'post_title' => 'This Is The Title',
    ],
]

```

Combining View models and Mappers
---------------------------------

[](#combining-view-models-and-mappers)

First, create a mapper for posts.

```
namespace App\Domain\Posts;

use EngageInteractive\LaravelViewModels\Mapper;

use App\Domain\Posts\Post;

class PostsMapper extends Mapper
{
    /**
     * Map a Post to a basic PHP array.
     *
     * @param \App\Domain\Posts\Post
     * @return array
     */
    public function map(Post $post)
    {
        return $post->only('title', 'author_name');
    }
}
```

Create a ViewModel, and call the mapper.

```
namespace App\Domain\Posts;

use EngageInteractive\LaravelViewModels\ViewModel;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Str;

class PostArchiveViewModel extends ViewModel
{
    protected $posts;

    /**
     * Initialise the View model.
     *
     * @param \Illuminate\Database\Eloquent\Collection
     * @return void
     */
    public function __construct(Collection $posts): void
    {
        $this->posts = $posts;
    }

    /**
     * Returns an array of posts.
     *
     * @return string
     */
    public function posts(): array
    {
        return (new PostsMapper)->all($this->posts);
    }

    /**
     * Returns the application home URI.
     *
     * @return string
     */
    public function HomeUri(): string
    {
        return route('home');
    }
}
```

Pass the view model into the view, with the posts mapped into the required format.

```
namespace App\Domain\Posts;

use App\Domain\Posts\Post;
use App\Domain\Posts\PostArchiveViewModel;
use App\Http\Controllers\Controller;

class PostArchiveController extends Controller
{
    /**
     * Show a Post.
     *
     * @return \Illuminate\Views\View
     */
    public function show()
    {
        $posts = Post::all();
        $model = new PostArchiveViewModel($posts);

        return view('post-archive.show', $model->array()),
    }
}
```

Laravel Compatibility
---------------------

[](#laravel-compatibility)

Works on Laravel 5.5+.

License
-------

[](#license)

Laravel View Models is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance68

Regular maintenance activity

Popularity26

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 78.3% 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 ~201 days

Recently: every ~220 days

Total

13

Last Release

189d ago

Major Versions

1.5.0 → 2.0.02023-06-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/e22aa318e38eb714e24cfaaffbd8ec50c2866cb0c9c17b31425033cee39123db?d=identicon)[engageinteractive](/maintainers/engageinteractive)

---

Top Contributors

[![wilkinsocks](https://avatars.githubusercontent.com/u/2356082?v=4)](https://github.com/wilkinsocks "wilkinsocks (18 commits)")[![JasonStainton](https://avatars.githubusercontent.com/u/27767499?v=4)](https://github.com/JasonStainton "JasonStainton (3 commits)")[![Roberth91](https://avatars.githubusercontent.com/u/6909290?v=4)](https://github.com/Roberth91 "Roberth91 (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/engageinteractive-laravel-view-models/health.svg)

```
[![Health](https://phpackages.com/badges/engageinteractive-laravel-view-models/health.svg)](https://phpackages.com/packages/engageinteractive-laravel-view-models)
```

###  Alternatives

[cagilo/cagilo

A set of open-source Blade components for the Laravel Framework

172996.5k](/packages/cagilo-cagilo)[orchid/blade-icons

An easy way inline SVG images in your Blade templates.

223.4M9](/packages/orchid-blade-icons)[wireui/heroicons

The Tailwind Heroicons for laravel blade by WireUI

43390.8k5](/packages/wireui-heroicons)[stillat/antlers-components

2656.0k1](/packages/stillat-antlers-components)[itstructure/laravel-grid-view

Grid view for laravel framework

2546.6k2](/packages/itstructure-laravel-grid-view)[ycs77/inertia-laravel-ssr-head

Simple SSR Head for Inertia Laravel

3211.5k](/packages/ycs77-inertia-laravel-ssr-head)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)