Symfony/Console para PHP: guía completa con ejemplos

1. ¿Qué es y para qué sirve?

Symfony/Console es un componente potente y flexible del framework Symfony, diseñado para crear comandos de consola (CLI) en PHP. Proporciona a los desarrolladores un conjunto completo de herramientas para construir scripts de línea de comandos interactivos, estructurados y fáciles de probar. En lugar de escribir scripts básicos con variables globales y funciones, Symfony/Console ofrece un enfoque orientado a objetos basado en clases de comandos, entrada/salida (Input/Output) y un sistema de preguntas.

¿Para qué sirve? En el desarrollo web moderno, los comandos de consola realizan tareas críticas: migraciones de bases de datos, ejecución de colas, generación de código, limpieza de caché, envío de correos masivos y muchos otros procesos en segundo plano. Symfony/Console permite estandarizar estas tareas, haciéndolas fáciles de leer, ampliar y mantener. La biblioteca maneja automáticamente los argumentos y opciones de los comandos, genera ayuda, formatea la salida y admite colores, lo que simplifica enormemente la vida del desarrollador.

Además, Symfony/Console no está vinculado exclusivamente al framework Symfony. Se puede usar en cualquier proyecto PHP (Laravel, Yii, PHP puro) como un componente independiente. Esto lo convierte en el estándar de facto para crear herramientas CLI en el ecosistema PHP. Gracias al soporte integrado para pruebas (a través de CommandTester) y un modelo de eventos, puedes escribir fácilmente pruebas unitarias para tus comandos y ampliar su funcionalidad con eventos.

2. Instalación

La instalación se realiza a través del gestor de dependencias Composer. Abre la terminal en la raíz de tu proyecto y ejecuta el comando:

composer require symfony/console

Si usas Symfony Flex (estándar para Symfony 4+), el paquete se configurará automáticamente. Para proyectos sin Symfony, necesitarás crear un archivo bin/console (o cualquier otro nombre) e inicializar la aplicación manualmente.

Después de la instalación, verifica que en tu composer.json aparezca la entrada:

{
    "require": {
        "symfony/console": "^6.0"
    }
}

3. Inicio rápido — ejemplo mínimo funcional

Vamos a crear un comando simple que muestre "¡Hola, Mundo!". Primero, crea el archivo bin/console:

#!/usr/bin/env php
<?php
// bin/console

require __DIR__ . '/../vendor/autoload.php';

use Symfony\Component\Console\Application;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

// Creamos la aplicación
$application = new Application('Mi App CLI', '1.0.0');

// Registramos el comando
$application->register('saludo')
    ->setDescription('Muestra un saludo')
    ->setCode(function (InputInterface $input, OutputInterface $output) {
        $output->writeln('¡Hola, Mundo!');
    });

// Ejecutamos la aplicación
$application->run();

Ahora haz el archivo ejecutable y ejecútalo:

chmod +x bin/console
php bin/console saludo

Verás en la consola: ¡Hola, Mundo!

Este es un ejemplo mínimo. En proyectos reales, los comandos se crean como clases separadas que heredan de Command, lo que garantiza una mejor organización del código.