ModelUpdater is a package helps you define the business logic and the validation needed to update an entire model's fields or just a few of them via a simple controller action and request handler.
Let's take a simple example to illustrate the purpose of this package:
Suppose you have a user model and you have an API endpoint to update a user's fields in the database where as the API consumer can update any field individually or all at once and the problem is that each field has its own logic needed before you store the updated value to the database.
Of course, there are a lot of different ways to handle this case, let's consider this simple and common one:
Old Way
As you can see the controller's method with two fields only becomes a big one, just imagine if you have 20+ fields!
class UserController extends Controller
{
public function update(Request $request)
{
$user = auth()->user();
// now you check for every field you allowed to update and perform the needed logic.
if($request->has('name')) {
// needed logic and validation
...
..
$user->name = $request->name
}
if($request->has('email')) {
// needed logic and validation
...
..
$user->email = $request->email
}
// update/save the model
$user->save();
// return a response
return response()->json();
}
}New Way (Simpler)
//App/Http/Controllers
use App\Updaters\UserUpdater;
class UserController extends Controller
{
public function store(UserUpdater $updates)
{
auth()->user()->fillUpdates($updates);
}
}
// App/Updaters
class UserUpdater extends Updater
{
/**
* Allowed fields to be updated.
*/
protected $fields = ['name'];
protected function name($value)
{
$this->request->validate(['name' => 'required|string|min:6']);
$this->model->name = $value;
}
}- Install the package via composer:
This package supports Laravel 5.5+ only
composer require binarytorch/model-updater- Add
Updatabletrait to your desired model:
class User extends Authenticatable
{
use BinaryTorch\UpdatableModel\Traits\Updateable;
}- Make a new model updater:
php artisan make:updater UserThis command will generate a new directory under app with namespace of Updaters and a file inside it called (in this example) UserUpdater.php.
- Make use in your controllers:
use App\Updaters\UserUpdater;
class UserController extends Controller
{
public function store(UserUpdater $updates)
{
auth()->user()->fillUpdates($updates);
}
}Please see CONTRIBUTING for details.
If you discover any security related issues, please email saleem@binarytorch.com.my instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.