Download the PHP package spatie/laravel-view-models without Composer
On this page you can find all versions of the php package spatie/laravel-view-models. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spatie/laravel-view-models
More information about spatie/laravel-view-models
Files in spatie/laravel-view-models
Package laravel-view-models
Short Description View models in Laravel
License MIT
Homepage https://github.com/spatie/laravel-view-models
Informations about the package laravel-view-models
View models in Laravel
Have you ever made a controller where you had to do a lot of work to prepare variables to be passed to a view? You can move that kind of work to a so called view model. In essence, view models are simple classes that take some data, and transform it into something usable for the view.
You'll find a more detailed explanation and some good examples in this blogpost on Stitcher.io.
Laravel's native view composers are not the same as the view models provided by this package. To learn more about the differences head over to this blogpost on Stitcher.io.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
You can install the package via composer:
Usage
A view model is a class where you can put some complex logic for your views. This will make your controllers a bit lighter. You can create a view model by extending the provided Spatie\ViewModels\ViewModel
.
Then you can use the view model class in your controller like this:
In a view you can do this:
All public methods and properties in a view model are automatically exposed to the view. If you don't want a specific method to be available in your view, you can ignore it.
All PHP's built in magic methods are ignored automatically.
View models as responses
It's possible to directly return a view model from a controller. By default, a JSON response with the data is returned.
This approach can be useful when working with AJAX submitted forms.
It's also possible to return a view directly:
Note that when the Content-Type
header of the request is set to JSON,
this approach will also return JSON data instead of a rendered view.
Exposing view functions
View models can expose functions which require extra parameters.
You can use these functions in the view like so:
Making a new view model
The package included an artisan command to create a new view model.
This view model will have the App\ViewModels
namespace and will be saved in app/ViewModels
.
or into a custom namespace, say, App\Blog
This view model will have the App\Blog\ViewModels
namespace and will be saved in app/Blog/ViewModels
.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
Credits
- Brent Roose
- All Contributors
License
The MIT License (MIT). Please see License File for more information.