itsdamien / laravel-model-transformer
A simple model transformer compatible with Laravel 5+.
Installs: 49 874
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=5.6.4
README
This package helps API developers to easily transform Eloquent models into collection that are convertible to JSON.
Installation
Installation using composer:
composer require itsdamien/laravel-model-transformer
Usage
Create a model transformer class by extending the AbstractTransformer
class:
class UserTransformer extends \ItsDamien\Transformer\AbstractTransformer { public function model($model) { return [ 'first_name' => $model->first_name, 'last_name' => $model->last_name, 'full_name' => $model->first_name.' '.$model->last_name, 'photos' => PhotoTransformer::transform($model->photos), ]; } }
Now you can call the transformer from any controller:
return response([ "user" => UserTransformer::transform(User::find(1)) ]); // Output: // { // "user":{ // "first_name":"John", // "last_name":"Doe", // "full_name":"John Doe", // "photos":[] // } // }
You can also pass a collection and the result will be an collection of transformed models:
return response([ "users" => UserTransformer::transform(User::all()) ]); // Output: // { // "users":[ // { // "first_name":"John", // "last_name":"Doe", // "full_name":"John Doe", // "photos":[] // }, // { // "first_name":"Dolores", // "last_name":"Abernathy", // "full_name":"Dolores Abernathy", // "photos":[] // }, // ] // }
Passing options to the transformer
You may need to pass some options from the controller to the transformer, you can do that by providing an array of options to the transform()
method as a second parameter:
UserTransformer::transform($user, ['foo' => 'bar']);
Now from inside the UserTransformer
you can check the options parameter:
class UserTransformer extends \ItsDamien\Transformer\AbstractTransformer { public function model($model) { return [ 'first_name' => $model->first_name, 'last_name' => $model->last_name, 'full_name' => $model->first_name.' '.$model->last_name, 'foo' => $this->options['foo'], ]; } }
Complex transformer
Your transformer will always transform your model with the model
method. Then you can alter the transformer by adding your with
or without
methods to the transform()
method as a third parameter:
class UserTransformer extends \ItsDamien\Transformer\AbstractTransformer { public function model($model) { return collect([ 'first_name' => $model->first_name, 'last_name' => $model->last_name, 'full_name' => $model->first_name.' '.$model->last_name, ]); } public function withId($model, \Illuminate\Support\Collection $collection) { return $collection->merge(collect([ 'id' => $model->id, ])); } public function withoutFullname($model, \Illuminate\Support\Collection $collection) { return $collection->except('full_name'); } }
Now call the transformer:
return UserTransformer::transform(User::find(1)); // Output: // { // "first_name":"John", // "last_name":"Doe", // "full_name":"John Doe" // }
return UserTransformer::transform(User::find(1), [], ['withId']); // Output: // { // "id":1, // "first_name":"John", // "last_name":"Doe", // "full_name":"John Doe" // }
return UserTransformer::transform(User::find(1), [], ['withoutFullname']); // Output: // { // "first_name":"John", // "last_name":"Doe", // }
return UserTransformer::transform(User::find(1), [], ['withId', 'withoutFullname']); // Output: // { // "id":1, // "first_name":"John", // "last_name":"Doe", // }