Comandos personalizados en Laravel con Artisan

Clase 10 de 33 • Curso Avanzado de Laravel

Resumen

Aprende a crear comandos personalizados en Laravel con Artisan para automatizar tareas críticas. Partimos de un caso práctico: un comando que envía una newsletter por correo a usuarios verificados, usando notificaciones, argumentos opcionales y barra de progreso. Verás cómo estructurar la firma, la descripción, el constructor y el método handle, además de configurar SMTP con Mailtrap para pruebas confiables.

¿Cómo crear un comando personalizado en Laravel con Artisan?

Crear un comando es directo. Laravel ofrece la base y tú defines la lógica. Además de los que trae Artisan, puedes añadir los tuyos con argumentos, opciones y preguntas.

Ejecuta el generador desde la terminal.
Define la firma y la descripción.
Implementa la lógica en handle.
Prueba rápido con un dd('hola').

php artisan make command
php artisan send newsletter

// Firma y descripción
a protected $signature = 'send newsletter';
a protected $description = 'Envía un correo electrónico';

// Prueba rápida en handle
dd('hola');

¿Qué define la firma y la descripción?

La firma es el nombre con el que invocas el comando: por ejemplo, send newsletter. La descripción funciona como ayuda para el usuario: "Envía un correo electrónico".

¿Dónde colocar la lógica con handle?

En handle va la lógica de negocio. Puedes inyectar dependencias con el constructor si lo necesitas.

¿Cómo enviar una newsletter con notificaciones y verificación de correo?

Para enviar correos de forma expresiva usaremos notificaciones. Crearemos una notification y filtraremos usuarios que hayan verificado su email. Luego activaremos las rutas de verificación y configuraremos SMTP con Mailtrap.

Genera la notificación desde la terminal.
Implementa la interfaz de verificación en el modelo usuario: MustVerifyEmail.
Filtra por email_verified_at no nulo y recorre la colección de Eloquent con each.
Envía con notify(new *NewsletterNotification*).
Habilita verificación de rutas pasando ['verified' => true].
Configura Mailtrap: integra con Laravel, copia valores y pégalos en tu .env.

php artisan make notification newsletter notification

// Consulta base: usuarios con email verificado
$builder = User::whereNotNull('email_verified_at');

// Envío de notificación
$user->notify(new NewsletterNotification);

// Rutas con verificación habilitada
['verified' => true];

Nota: si la barra de progreso marca error de inicialización, reemplaza "create progress bar" por progress start antes de ejecutar de nuevo.

¿Cómo añadir argumentos, filtros y barra de progreso al comando?

Para más control, agrega un argumento opcional tipo array llamado email. Si lo pasas, el comando enviará solo a esos correos. También usaremos un query builder para componer la consulta, un whereIn para filtrar y una barra de progreso para feedback claro.

Argumento opcional tipo array en la firma: email?*.
Recupera el argumento con $this->arguments('email').
Usa una variable builder para la consulta y aplica whereIn si hay correos.
Calcula count para iniciar la barra de progreso.
Avanza la barra con progressAdvance en cada envío y ciérrala con progressFinish.
Mensajes informativos: "Se enviaron X correos" o "No se envió ningún correo".

// Firma con argumento opcional tipo array
protected $signature = 'send newsletter {email?*}';

// Recuperar argumento y construir la query
$email = $this->arguments('email');
$builder = User::whereNotNull('email_verified_at');

if ($email) {
    $builder->whereIn('email', $email);
}

$count = $builder->count();
$this->output->progressStart($count);

// Envío + barra de progreso
$builder->each(function ($user) {
    $user->notify(new NewsletterNotification);
    $this->output->progressAdvance();
});

$this->output->progressFinish();

// Mensajes
$this->info("Se enviaron {$count} correos");
// O, si no hay usuarios:
$this->info('No se envió ningún correo');

¿Te animas al reto final? Crea un comando que notifique a los usuarios no verificados registrados hace más de una semana. Cuéntame en comentarios cómo lo resolverías y qué filtros agregarías.

Martin Campos

student•

Con Laravel Sail, ya no es necesario utilizar Mailtrap, si no con el contenedor de Mailhog simular el servicio del correo electrónico en el local.

Igual han de saber un poco de docker para correr los contenedores.

Mariano Gastón Paduani

student•

Para sumar a este comentario, con Sail corriendo, se puede acceder a la interfaz de MailHog en ``` localhost:8025

Miguel Angel Muñoz Pozos

student•

reto cumplido

lo único que hay que hacer es en la consulta eso es lo importante yo la solucione asi

 $builder->whereNull('email_verified_at')
 ->whereRaw('email_verified_at BETWEEN DATE_ADD(CURDATE(), INTERVAL -7 DAY) AND CURDATE()');

Jean Nuñez

student•

gracias esto ayuda un monton

Sergio Ojeda

teacher•

Exactamente. Hay otra manera donde puedes hacer la query sin necesidad de hacer un whereRaw, sino directamente los métodos de Eloquent.

Resultado: https://github.com/sojeda/platzi-ecommerce-api/commit/67779ee91de4a57895621a3538bbdb3790c9fee2

Mauricio Galvez

student•

Mi solución al reto

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Models\User;
use Carbon\Carbon;

class RequestEmailVerification extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'request:emailverification';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Send an email to all the users that have not verify their email';

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }

    /**
     * Execute the console command.
     *
     * @return int
     */
    public function handle()
    {
        $builder = User::query()
                        ->whereNull('email_verified_at')
                        ->whereDate('created_at', '<=', Carbon::now()->subDays(7)->format('Y-m-d'));

        if ($count = $builder->count()) {
            $this->info("{$count} email will be sent");
            $this->output->progressStart($count);

            $builder->each(function (User $user) {
                $user->sendEmailVerificationNotification();
                $this->output->progressAdvance();
            });

            $this->output->progressFinish();
            $this->info('emails sent');
        } else {
            $this->info('No email sent');
        }

        return 0;
    }
}

Mauricio Galvez

student•

Si tienen este error: Cannot send message without a sender address ejecuten esto: php artisan config:clear

Añaqui Apolinar Morales

student•

Me dice que se envian demaciadosmensajes por segundo, alguien lo ha solucionado ?

Expected response code 354 but got code "550", with message "550 5.7.0 Requested action not taken: too many emails per second

Juan Guillermo Perez Cardozo

student•

este profe explica muy bien para quienes ya tenemos esos conceptos avanzados, pues si he hecho varios comandos en mis aplicaciones, pero aca aprendi algunas cosas como pasar param al comando

Alejandro Valenzuela

student•

Buenas, tengo el siguiente error al correr el comando:

mi enviarCorreCoamndo.php

<?php

namespace App\Console\Commands;
use App\Notifications\nuevaInformacionNotificacion;
use App\User;
use Illuminate\Console\Command;
class EnviarCorreoComando extends Command
{    
    protected $signature = 'enviar:usuarioNoAutenticado {emails?*}';
    protected $description = 'Envia un correo electronico a los usuarios que no se autenticaron';
   
    public function handle()
    {
        $emails = $this->argument('emails');
        $builder = User::query();

        if ($emails) {
            $builder->whereIn('email', $emails);
        }
        $cuantos = $builder->count();
        if ($cuantos) {
            $builder->whereNull('email_verified_at')
                ->each(function  (User $user) {
                    $user->notify(new nuevaInformacionNotificacion());
                });
            $this->info("Se enviarion {$cuantos} correos");
            return ;
        }
        $this->info('No se enviaron ningun correo');
        return ;

    }
}

nuevaInformacionNotificacion.php:

<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\MailMessage;

class nuevaInformacionNotificacion extends Notification
{
    use Queueable;
    public function via($notifiable)
    {
        return ['mail'];
    }
    public function toMail($notifiable)
    {
        return (new MailMessage)
                    ->line('The introduction to the notification.')
                    ->action('Notification Action', url('/'))
                    ->line('Thank you for using our application!');
    }
    public function toArray($notifiable)
    {
        return [
            //
        ];
    }
}

Si alguien tiene alguna sugerencia de cual es el problema, le agradecería su ayuda! Saludos Alejandro.

Alejandro Valenzuela

student•

Bueno me contesto a mi mismo, el problema para por el lado de Ubuntu, instale lo siguiente:

sudo apt-get install php-xml

Saludos.

Miguel Ángel Mateo Tavarez

student•

Sería interesante un curso especializado en Eloquent a profundidad ¿Han pensado en ello?

Kevin Fiorentino

student•

Compañero! Toda sugerencia de realización de cursos será muy bien recibido si envía el feedback a team@platzi.com para que puedan evaluarlo. Saludos!

Kenneth Angulo L

student•

Con la cuenta gratuita de mailtrap se genera un error al tratar de enviar correos masivamente:

Expected response code "354" but got code "550", with message "550 5.7.0 Too many emails per second. Please upgrade your plan https://mailtrap.io/billing/plans/testing".

para superar esto, una solucion muy simple, demorar la ejecucion del codigo un par de segundos:

// Se envia notificacion a cada usuario $builder->whereNotNull("email_verified_at") ->each(function (User $user) { sleep(5); $user->notify(new NewsletterNotification()); $this->output->progressAdvance(); });

Deivis Andrés Cervantes

student•

Reto cumplido. Usé la librería Carbon para manejar las fechas:

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Models\User;
use App\Notifications\NewsletterNotification;
use Illuminate\Support\Carbon;

class SendReminderCommand extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'send:reminder {emails?*}';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Envía un recordatorio a los usuarios que no han confirmado su correo electrónico.';

    /**
     * Execute the console command.
     */
    public function handle()
    {
        $emails = $this->argument('emails');

        $builder = User::query();

        if ($emails) {
            $builder->whereIn('email', $emails);
        }

        $count = $builder->count();

        if ($count) {
            $this->output->progressStart();

            $builder->whereNull('email_verified_at')
            ->whereDate('created_at', '<', Carbon::now()->subWeek())
            ->each(function(User $user) {
                $user->notify(new NewsletterNotification);
                $this->output->progressAdvance();
            });

            $count = $builder->count();
            $this->output->progressFinish();
        }

        $this->info($count ? "Se enviaron {$count} correos." : "No se envió ningún correo.");
    }
}

Deivis Andrés Cervantes

student•

Yo estoy trabajando en Laravel 10. A mi me pareció más estético el resultado con el siguiente código en el handler del archivo SendNewsletterCommand:

public function handle()
{
    $emails = $this->argument('emails');

    $builder = User::query();

    if ($emails) {
        $builder->whereIn('email', $emails);
    }

    $count = $builder->count();

    if ($count) {
        $this->output->progressStart();

        $builder->whereNotNull('email_verified_at')
                ->each(function (User $user) {
                    $user->notify(new NewsletterNotification);
                    $this->output->progressAdvance();
                });

        $count = $builder->count();
        $this->output->progressFinish();
    }

    $this->info($count ? "Se enviaron {$count} correos." : "No se envió ningún correo.");
}

lucas cartisano

student•

Pasa por alto conceptos que nunca se explicaron, ni aquí ni en los cursos requeridos, cada vez peor la calidad de los cursos

Maia Paratcha

student•

Espero que hagan otro curso de laravel avanzado donde se puedan explicar correctamente los distintos conceptos. Y ya que estoy expresando expectativas, que sea version 10.

Juan David Rueda Quiroga

student•

En el momento 2:48 creo que se equivoca, no es una migración, es nuestro comando

Fernando Mejia

student•

Para que no se sobre escriba el texto info durante la ejecucion de la barra puedes usar un return y cambiar el orden que primero termine la barra y despues escriba el mensaje:

        if ($count) {
            $this->output->progressStart($count);

            $builder->whereNotNull('email_verified_at')->each(function(User $user) {
                $user->notify(new NewsletterNotification());
                $this->output->progressAdvance();
            });


            $this->output->progressFinish();
            return $this->info('Se enviaron ' . $count . ' emails');
        }

Tambien puedes acceder a los metodos warn() y error() que aceptarn cadenas de textos para cambiar el color del texto que se imprime en consola

Tomas Goldenberg

student•

Muy interesante...

Marc Garcia Torrent

student•

Hola, para qué pones el método query() en cada modelo de eloquent que utilizas?

Brian Sánchez Izquierdo

student•

Para ejecutar una consulta especifica mediante Eloquent, el ORM de Laravel.

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Models\User;
use Carbon\Carbon;

class RequestEmailVerification extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'request:emailverification';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Send an email to all the users that have not verify their email';

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }

    /**
     * Execute the console command.
     *
     * @return int
     */
    public function handle()
    {
        $builder = User::query()
                        ->whereNull('email_verified_at')
                        ->whereDate('created_at', '<=', Carbon::now()->subDays(7)->format('Y-m-d'));

        if ($count = $builder->count()) {
            $this->info("{$count} email will be sent");
            $this->output->progressStart($count);

            $builder->each(function (User $user) {
                $user->sendEmailVerificationNotification();
                $this->output->progressAdvance();
            });

            $this->output->progressFinish();
            $this->info('emails sent');
        } else {
            $this->info('No email sent');
        }

        return 0;
    }
}

<?php

namespace App\Console\Commands;
use App\Notifications\nuevaInformacionNotificacion;
use App\User;
use Illuminate\Console\Command;
class EnviarCorreoComando extends Command
{    
    protected $signature = 'enviar:usuarioNoAutenticado {emails?*}';
    protected $description = 'Envia un correo electronico a los usuarios que no se autenticaron';
   
    public function handle()
    {
        $emails = $this->argument('emails');
        $builder = User::query();

        if ($emails) {
            $builder->whereIn('email', $emails);
        }
        $cuantos = $builder->count();
        if ($cuantos) {
            $builder->whereNull('email_verified_at')
                ->each(function  (User $user) {
                    $user->notify(new nuevaInformacionNotificacion());
                });
            $this->info("Se enviarion {$cuantos} correos");
            return ;
        }
        $this->info('No se enviaron ningun correo');
        return ;

    }
}

<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\MailMessage;

class nuevaInformacionNotificacion extends Notification
{
    use Queueable;
    public function via($notifiable)
    {
        return ['mail'];
    }
    public function toMail($notifiable)
    {
        return (new MailMessage)
                    ->line('The introduction to the notification.')
                    ->action('Notification Action', url('/'))
                    ->line('Thank you for using our application!');
    }
    public function toArray($notifiable)
    {
        return [
            //
        ];
    }
}

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Models\User;
use App\Notifications\NewsletterNotification;
use Illuminate\Support\Carbon;

class SendReminderCommand extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'send:reminder {emails?*}';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Envía un recordatorio a los usuarios que no han confirmado su correo electrónico.';

    /**
     * Execute the console command.
     */
    public function handle()
    {
        $emails = $this->argument('emails');

        $builder = User::query();

        if ($emails) {
            $builder->whereIn('email', $emails);
        }

        $count = $builder->count();

        if ($count) {
            $this->output->progressStart();

            $builder->whereNull('email_verified_at')
            ->whereDate('created_at', '<', Carbon::now()->subWeek())
            ->each(function(User $user) {
                $user->notify(new NewsletterNotification);
                $this->output->progressAdvance();
            });

            $count = $builder->count();
            $this->output->progressFinish();
        }

        $this->info($count ? "Se enviaron {$count} correos." : "No se envió ningún correo.");
    }
}

public function handle()
{
    $emails = $this->argument('emails');

    $builder = User::query();

    if ($emails) {
        $builder->whereIn('email', $emails);
    }

    $count = $builder->count();

    if ($count) {
        $this->output->progressStart();

        $builder->whereNotNull('email_verified_at')
                ->each(function (User $user) {
                    $user->notify(new NewsletterNotification);
                    $this->output->progressAdvance();
                });

        $count = $builder->count();
        $this->output->progressFinish();
    }

    $this->info($count ? "Se enviaron {$count} correos." : "No se envió ningún correo.");
}

        if ($count) {
            $this->output->progressStart($count);

            $builder->whereNotNull('email_verified_at')->each(function(User $user) {
                $user->notify(new NewsletterNotification());
                $this->output->progressAdvance();
            });


            $this->output->progressFinish();
            return $this->info('Se enviaron ' . $count . ' emails');
        }

Comandos personalizados en Laravel con Artisan

Laravel y Base de Datos

Entorno de trabajo y repaso de Laravel

Qué aprenderás sobre Laravel Avanzado

Instalación de Laravel con Composer

Configuración SQLite y API productos Laravel

Instalación, configuración y uso de Homestead

Instalar Laravel Sanctum

Tipos de autenticación en Laravel

Manejo de tu base de datos con Laravel

API Resource Laravel para JSON preciso

Manejo de relaciones en bases de datos con Laravel

Cómo usar relaciones polimórficas en Laravel

La terminal de Laravel

Comandos personalizados en Laravel con Artisan

Ejecutando comandos desde la API

Programación de tareas

Eventos y tareas de Laravel

Eventos y Listeners en Laravel

Eventos de Eloquent

Queues y jobs en Laravel con driver database

Listeners a jobs con JobQueue en Laravel

Laravel Horizon

Manejo de errores

Cómo capturar y leer errores con la clase Handler

Excepciones personalizadas

Manejo de excepciones HTTP con abort en Laravel

Configuración de logs y channels en Laravel

El corazón de Laravel

Ciclo de vida de una aplicación en Laravel

Qué es el service container de Laravel

¿Cómo funciona un service container?

Service providers: cargar componentes sin instanciar

Creación de paquetes

Cómo crear paquetes Laravel con Composer

Propiedades para manejo de dependencias

Comprende el archivo composer.json

Cómo Composer carga clases automáticamente

Crear mis propios Services Providers

Cómo publicar archivos con Service Provider

Instalando paquetes desde GitHub con Composer

Publicar tu paquete PHP en Packages