1. Qu'est-ce que Symfony/Console et pourquoi l'utiliser ?

Symfony/Console est un composant puissant et flexible du framework Symfony, conçu pour créer des commandes console (CLI) en PHP. Il offre aux développeurs un ensemble complet d'outils pour construire des scripts en ligne de commande interactifs, structurés et facilement testables. Au lieu d'écrire des scripts basiques avec des variables et fonctions globales, Symfony/Console propose une approche orientée objet basée sur des classes de commandes, des entrées/sorties (Input/Output) et un système de questions.

Pourquoi en avez-vous besoin ? Dans le développement web moderne, les commandes console exécutent des tâches critiques : migrations de base de données, lancement de files d'attente, génération de code, vidage du cache, envoi d'emails en masse et autres processus d'arrière-plan. Symfony/Console permet de standardiser ces tâches, les rendant lisibles, extensibles et maintenables. La bibliothèque gère automatiquement les arguments et options des commandes, génère l'aide, formate la sortie et prend en charge la coloration syntaxique, ce qui simplifie grandement la vie du développeur.

De plus, Symfony/Console n'est pas strictement lié au framework Symfony. Vous pouvez l'utiliser dans n'importe quel projet PHP (Laravel, Yii, PHP pur) en tant que composant autonome. Cela en fait le standard de facto pour la création d'outils CLI dans l'écosystème PHP. Grâce à la prise en charge intégrée des tests (via CommandTester) et à un modèle événementiel, vous pouvez facilement écrire des tests unitaires pour vos commandes et étendre leurs fonctionnalités avec des événements.

2. Installation

L'installation se fait via le gestionnaire de dépendances Composer. Ouvrez un terminal à la racine de votre projet et exécutez la commande :

composer require symfony/console

Si vous utilisez Symfony Flex (standard pour Symfony 4+), le paquet sera automatiquement configuré. Pour les projets sans Symfony, vous devrez créer un fichier bin/console (ou tout autre nom) et initialiser l'application manuellement.

Après l'installation, vérifiez que votre composer.json contient l'entrée :

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

3. Démarrage rapide — un exemple minimal fonctionnel

Créons une commande très simple qui affiche "Bonjour, le monde !". Commencez par créer le fichier 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;

// Création de l'application
$application = new Application('Mon App CLI', '1.0.0');

// Enregistrement de la commande
$application->register('bonjour')
    ->setDescription('Affiche un message de bienvenue')
    ->setCode(function (InputInterface $input, OutputInterface $output) {
        $output->writeln('Bonjour, le monde !');
    });

// Lancement de l'application
$application->run();

Rendez maintenant le fichier exécutable et lancez-le :

chmod +x bin/console
php bin/console bonjour

Vous verrez dans la console : Bonjour, le monde !

Ceci est un exemple minimal. Dans les projets réels, les commandes sont créées sous forme de classes séparées héritant de Command, ce qui garantit une meilleure organisation du code.

4. Méthodes, fonctions et classes principales

Examinons les classes et méthodes clés de la bibliothèque. Pour chaque