Framework CLI para PHP (Symfony Console)

¿Qué es un framework CLI para PHP?

Un framework CLI (Command Line Interface) para PHP es una herramienta que permite a los desarrolladores crear comandos de consola, scripts y utilidades en el lenguaje PHP. La solución más popular y potente en esta área es el componente Symfony Console. Proporciona una arquitectura lista para manejar argumentos, opciones, salida de texto en color, sugerencias interactivas y generación automática de ayuda.

¿Para qué sirve un framework CLI?

En el desarrollo moderno, los comandos de consola se utilizan para automatizar tareas: migraciones de base de datos, limpieza de caché, generación de código, ejecución de pruebas, procesamiento de colas y mucho más. Sin un framework, tendrías que analizar manualmente los argumentos de la línea de comandos, manejar errores y formatear la salida. Symfony Console hace que este proceso sea simple y estandarizado.

¿Cómo instalarlo?

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

composer require symfony/console

Después de esto, podrás usar todas las funcionalidades del framework en tu aplicación PHP.

Funciones principales

• Creación de comandos: Cada comando es una clase separada que hereda de Command.
• Argumentos y opciones: Define fácilmente parámetros obligatorios y opcionales, así como opciones con valores predeterminados.
• Salida en color: Usa estilos para resaltar errores, advertencias y mensajes exitosos.
• Interactividad: Soporte para preguntas, selección de listas y autocompletado de entrada.
• Ayuda automática: Al ejecutar un comando con el flag --help se genera documentación completa.
• Tablas y barras de progreso: Visualización conveniente de datos en forma de tablas e indicadores de progreso.

Ejemplo de código en PHP

Creemos un comando simple que salude al usuario:

// src/Command/GreetCommand.phpnamespace App\\Command;

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

class GreetCommand extends Command{    protected static $defaultName = 'app:greet';

    protected function configure()    {        $this            ->setDescription('Saluda al usuario')            ->addArgument('name', InputArgument::REQUIRED, 'Nombre del usuario');    }

    protected function execute(InputInterface $input, OutputInterface $output)    {        $name = $input->getArgument('name');        $output->writeln('¡Hola, ' . $name . '!');        return Command::SUCCESS;    }}

Ejecuta el comando en la terminal:

php bin/console app:greet Juan

Verás: ¡Hola, Juan!

Cuándo usarlo

Symfony Console es ideal para cualquier proyecto PHP que requiera la creación de utilidades de consola: desde scripts simples hasta aplicaciones CLI complejas con docenas de comandos. Es una herramienta indispensable para DevOps, automatización de despliegues y administración. Si trabajas con frameworks Symfony, Laravel (a través de Artisan) o cualquier otra aplicación PHP, usa este componente para crear código limpio y mantenible.