Como implementar Actions en Laravel

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:

<?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:

<?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:

<?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:

<?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());
    }
}

Necesitamos crear un service provider con lo siguiente:

<?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,
	];
}

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