Consola Artisan

php artisan list

php artisan help migrate

php artisan tinker

// Obtener y comprobar un usuario
>>> App\Models\User::find(1)
// Crear un registro con una factory
>>> App\Models\User::factory()->create()
// Invocar directamente una clase de servicio
>>> app(App\Services\OrderService::class)->process(1)

php artisan make:command ImportProducts

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;

class ImportProducts extends Command
{
    /**
     * Nombre del comando y definición de argumentos/opciones
     */
    protected $signature = 'import:products';

    /**
     * Descripción del comando (se muestra en php artisan list)
     */
    protected $description = 'Importa datos de productos desde un CSV';

    /**
     * Lógica de ejecución del comando
     */
    public function handle(): void
    {
        $this->info('Comenzando la importación...');
        // Escribe aquí el procesamiento
        $this->info('Terminado.');
    }
}

protected $signature = 'import:products
                        {file : Ruta del CSV a importar}
                        {--limit= : Número máximo de filas a importar}
                        {--dry-run : No guarda realmente en la BD (solo para comprobar)}';

public function handle(): void
{
    $file    = $this->argument('file');       // Obtener argumento
    $limit   = $this->option('limit');        // Obtener opción
    $dryRun  = $this->option('dry-run');      // Opción flag (bool)

    $this->info("Archivo: {$file}");

    if ($dryRun) {
        $this->warn('Modo dry-run: se omitirá el guardado en la BD');
    }
}

use App\Enums\ReportType;

public function handle(): void
{
    // Obtiene argumentos/opciones como instancia CommandInput
    $from = $this->input()->date('from');
    $type = $this->input()->enum('type', ReportType::class);
    $limit = $this->input()->integer('limit');
}

$queue = $this->input('queue', 'default');

$this->info('El proceso terminó correctamente');   // Verde
$this->warn('Esta operación no se puede deshacer'); // Amarillo
$this->error('Se ha producido un error');           // Rojo
$this->line('Texto normal');                        // Sin color
$this->comment('Información adicional');            // Gris claro

// Entrada de texto
$name = $this->ask('Introduce el nombre del responsable');

// Con valor por defecto
$env = $this->ask('Selecciona el entorno', 'production');

// Información sensible (no se muestra al escribir)
$password = $this->secret('Introduce la clave de API');

// Confirmación Sí/No
if (! $this->confirm('¿Importar a la BD de producción?')) {
    $this->info('Cancelado.');
    return;
}

// Elegir de entre opciones
$format = $this->choice('Elige el formato de salida', ['csv', 'json', 'xml'], 0);

use App\Models\Product;

// Al pasar una colección, se muestra la barra automáticamente
$this->withProgressBar(Product::cursor(), function (Product $product) {
    $this->processProduct($product);
});

$total = Product::count();
$bar = $this->output->createProgressBar($total);
$bar->start();

Product::cursor()->each(function (Product $product) use ($bar) {
    $this->processProduct($product);
    $bar->advance();
});

$bar->finish();
$this->newLine();

<?php

namespace App\Console\Commands;

use App\Models\Order;
use Illuminate\Console\Command;

class PruneOldOrders extends Command
{
    protected $signature = 'orders:prune {--days=90 : Antigüedad mínima de los datos a eliminar}';

    protected $description = 'Elimina los pedidos completados con más antigüedad que la indicada';

    public function handle(): void
    {
        $days = (int) $this->option('days');

        if (! $this->confirm("¿Eliminar pedidos completados con más de {$days} días?")) {
            $this->info('Cancelado.');
            return;
        }

        $deleted = Order::where('status', 'completed')
            ->where('created_at', '<', now()->subDays($days))
            ->delete();

        $this->info("{$deleted} pedidos eliminados.");
    }
}

use Illuminate\Support\Facades\Schedule;

// Diario a las 2 de la madrugada
Schedule::command('orders:prune --days=90')->dailyAt('2:00');

// Cada lunes a las 9
Schedule::command('import:products storage/weekly.csv')->weeklyOn(1, '9:00');

<?php

namespace Tests\Feature\Commands;

use App\Models\Order;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class PruneOldOrdersTest extends TestCase
{
    use RefreshDatabase;

    public function test_it_deletes_old_completed_orders(): void
    {
        // Crea un pedido completado hace más de 90 días
        Order::factory()->create([
            'status'     => 'completed',
            'created_at' => now()->subDays(100),
        ]);

        // Pedido reciente (no debería eliminarse)
        Order::factory()->create([
            'status'     => 'completed',
            'created_at' => now()->subDays(10),
        ]);

        $this->artisan('orders:prune', ['--days' => 90])
            ->expectsConfirmation('¿Eliminar pedidos completados con más de 90 días?', 'yes')
            ->expectsOutput('1 pedidos eliminados.')
            ->assertExitCode(0);

        $this->assertDatabaseCount('orders', 1);
    }

    public function test_it_cancels_when_user_declines(): void
    {
        Order::factory()->create(['status' => 'completed', 'created_at' => now()->subDays(100)]);

        $this->artisan('orders:prune', ['--days' => 90])
            ->expectsConfirmation('¿Eliminar pedidos completados con más de 90 días?', 'no')
            ->expectsOutput('Cancelado.')
            ->assertExitCode(0);

        $this->assertDatabaseCount('orders', 1);
    }
}

# Crear un comando nuevo
php artisan make:command CommandName

# Lista de comandos disponibles
php artisan list

# Ayuda de un comando
php artisan help command:name

# Iniciar Tinker
php artisan tinker