Como implementar Actions en Laravel

Feb 10, 2022

Are you looking for a mentor?

Whether you're a beginner or need assistance with a work-related project, I'm available to provide support.

Check out the gig on Fiverr.

Agrega tu publicadad

Este artículo tiene más de un año de antigüedad, el contenido pudiera estar obsoleto.

Que son las actions? Pues basicamente son clases que se encargan de tareas especificas dentro de nuestra aplicación.

Tomemos el ejemplo de crear un blog y necesitamos crear articulos y para eso vamos a crear dentro de nuestra aplicacion varias carpetas y archivos para lograr nuestro cometido.

Primero creemos los siguientes directorios, dentro de app tendremos: Actions/Article y vamos a crear un archivo llamado ArticleCreate y quedaria de la siguiente forma:

 1<?php
 2 
 3namespace App\Actions\Article;
 4 
 5use App\Models\Article;
 6 
 7class ArticleCreate
 8{
 9 
10    /**
11     * Undocumented function
12     *
13     * @param array $input
14     * @return Article
15     */
16    public function __invoke(array $input): Article
17    {
18        // todo
19    }
20 
21}

<?php

namespace App\Actions\Article;

use App\Models\Article;

class ArticleCreate
{

    /**
     * Undocumented function
     *
     * @param array $input
     * @return Article
     */
    public function __invoke(array $input): Article
    {
        // todo
    }

}

Tambien, dentro de app vamos a crear estos otros directorios Contratcs/Actions junto a un archivo llamado ArticlesCreate debe quedar de esta forma:

 1<?php
 2namespace App\Contracts\Actions;
 3 
 4use App\Models\Article;
 5 
 6interface ArticlesCreate
 7{
 8    /**
 9     * Undocumented function
10     *
11     * @param array $data
12     * @return Article
13     */
14    public function __invoke(array $data): Article;
15}

<?php
namespace App\Contracts\Actions;

use App\Models\Article;

interface ArticlesCreate
{
    /**
     * Undocumented function
     *
     * @param array $data
     * @return Article
     */
    public function __invoke(array $data): Article;
}

Y ya, es lo unico que vamos hacer con este archivo.

Pasemos a lo mas divertido

Volviendo a nuestro archivo ArticleCreate vamos a implementar nuestro contrato ArticlesCreate para que quede de la siguiente forma:

 1<?php
 2 
 3namespace App\Actions\Article;
 4 
 5use App\Contracts\Actions\ArticlesCreate;
 6use App\Models\Article;
 7 
 8class ArticleCreate implements ArticlesCreate
 9{
10 
11    /**
12     * Undocumented function
13     *
14     * @param array $input
15     * @return Article
16     */
17    public function __invoke(array $input): Article
18    {
19        return Article::create([
20            'title' => $input['title'],
21            'body' => $input['body'],
22        ]);
23    }
24 
25}

<?php

namespace App\Actions\Article;

use App\Contracts\Actions\ArticlesCreate;
use App\Models\Article;

class ArticleCreate implements ArticlesCreate
{

    /**
     * Undocumented function
     *
     * @param array $input
     * @return Article
     */
    public function __invoke(array $input): Article
    {
        return Article::create([
            'title' => $input['title'],
            'body' => $input['body'],
        ]);
    }

}

Con este cambio dejamos listo nuestra accion para crear articulos. Tenemos ahora que hacer la implementacion de nuestra accion para hacer el uso de ella.

Para implementar la accion vamos hacer uso de los "Single Action Controllers" y haremos lo siguiente:

 1<?php
 2 
 3namespace App\Http\Controllers;
 4 
 5use App\Contracts\Actions\ArticlesCreate;
 6use App\Http\Controllers\Controller;
 7 
 8class ArticleStoreController extends Controller
 9{
10    /**
11     * Undocumented function
12     *
13     * @param ArticlesCreate $articleCreate
14     * @return \Illuminate\Http\Response
15     */
16    public function __invoke(ArticlesCreate $articleCreate)
17    {
18        $article = $articleCreate($request->all());
19    }
20}

<?php

namespace App\Http\Controllers;

use App\Contracts\Actions\ArticlesCreate;
use App\Http\Controllers\Controller;

class ArticleStoreController extends Controller
{
    /**
     * Undocumented function
     *
     * @param ArticlesCreate $articleCreate
     * @return \Illuminate\Http\Response
     */
    public function __invoke(ArticlesCreate $articleCreate)
    {
        $article = $articleCreate($request->all());
    }
}

Nuestra accion al hacer de tipo invocable, nos permite acceder a ella como si fuera una funcion

Necesitamos crear un service provider con lo siguiente:

 1<?php
 2 
 3namespace App\Providers;
 4 
 5use App\Actions\Article\ArticleCreateAction;
 6use App\Contracts\Actions\ArticlesCreate;
 7use Illuminate\Support\ServiceProvider;
 8 
 9class ActionServiceProvider extends ServiceProvider
10{
11    public array $bindings = [
12        ArticlesCreate::class => ArticleCreateAction::class,
13    ];
14}

<?php

namespace App\Providers;

use App\Actions\Article\ArticleCreateAction;
use App\Contracts\Actions\ArticlesCreate;
use Illuminate\Support\ServiceProvider;

class ActionServiceProvider extends ServiceProvider
{
    public array $bindings = [
        ArticlesCreate::class => ArticleCreateAction::class,
    ];
}

No olviden agregarlo en la lista de service providers en app.php

Y ya para finalizar tengo que agradecer a Luke Downing y su charla en el Laracon "Actions are a Dev's Best Friend", para el mi agradecimiento porque su charla me motivo a realizar este pequeño articulo y refactorizar este blog.

Btw, visiten a Luke en su perfil de twitter: @LukeDowning19

Autor

Angel Cruz

Como implementar Actions en Laravel

#Pasemos a lo mas divertido

Pasemos a lo mas divertido