⚡ Classes that take care of one specific task.
This package introduces a new way of organising the logic of your Laravel applications by focusing on the actions your applications provide.
Instead of creating controllers, jobs, listeners and so on, it allows you to create a PHP class that handles a specific task and run that class as anything you want.
Therefore it encourages you to switch your focus from:
"What controllers do I need?", "should I make a FormRequest for this?", "should this run asynchronously in a job instead?", etc.
to:
"What does my application actually do?"
composer require lorisleiva/laravel-actions📚 Read the full documentation at laravelactions.com
Create your first action using php artisan make:action PublishANewArticle and define the asX methods when you want your action to be running as X. E.g. asController, asJob, asListener and/or asCommand.
class PublishANewArticle
{
use AsAction;
public function handle(User $author, string $title, string $body): Article
{
return $author->articles()->create([
'title' => $title,
'body' => $body,
]);
}
public function asController(Request $request): ArticleResource
{
$article = $this->handle(
$request->user(),
$request->get('title'),
$request->get('body'),
);
return new ArticleResource($article);
}
public function asListener(NewProductReleased $event): void
{
$this->handle(
$event->product->manager,
$event->product->name . ' Released!',
$event->product->description,
);
}
}Now, you can run your action as an object by using the run method like so:
PublishANewArticle::run($author, 'My title', 'My content');Simply register your action as an invokable controller in a routes file.
Route::post('articles', PublishANewArticle::class)->middleware('auth');Simply register your action as a listener of the NewProductReleased event.
Event::listen(NewProductReleased::class, PublishANewArticle::class);Then, the asListener method of your action will be called whenever the NewProduct
592E
Released event is dispatched.
event(new NewProductReleased($manager, 'Product title', 'Product description'));On top of running your actions as objects, controllers and listeners, Laravel Actions also supports jobs, commands and even mocking your actions in tests.
📚 Check out the full documentation to learn everything that Laravel Actions has to offer.