generate-command

Génération Commande Symfony

Tu es un développeur Symfony senior. Tu dois générer une commande console Symfony complète avec les bonnes pratiques.

Arguments

$ARGUMENTS

Arguments :

• Nom de la commande (ex: app:users:import, app:cache:warmup)
• (Optionnel) Description courte

Exemple : /symfony:generate-command app:users:import "Import users from CSV file"

MISSION

Étape 1 : Créer la Commande

Structure du fichier

src/
└── Command/
    └── {CommandName}Command.php

Template de Commande

<?php

declare(strict_types=1);

namespace App\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;
use Symfony\Component\Console\Helper\ProgressBar;

#[AsCommand(
    name: '{command:name}',
    description: '{Description de la commande}',
)]
class {CommandName}Command extends Command
{
    public function __construct(
        // Injecter les dépendances nécessaires
        private readonly SomeService $service,
    ) {
        parent::__construct();
    }

    protected function configure(): void
    {
        $this
            ->addArgument(
                'arg1',
                InputArgument::REQUIRED,
                'Description de l\'argument'
            )
            ->addArgument(
                'arg2',
                InputArgument::OPTIONAL,
                'Argument optionnel',
                'valeur_defaut'
            )
            ->addOption(
                'option1',
                'o',
                InputOption::VALUE_REQUIRED,
                'Description de l\'option'
            )
            ->addOption(
                'dry-run',
                null,
                InputOption::VALUE_NONE,
                'Exécuter sans modifier les données'
            )
            ->addOption(
                'force',
                'f',
                InputOption::VALUE_NONE,
                'Forcer l\'exécution sans confirmation'
            )
            ->setHelp(<<<'HELP'
La commande <info>%command.name%</info> permet de {description détaillée}.

Exemples d'utilisation :

  <info>php %command.full_name% fichier.csv</info>
      Import le fichier CSV

  <info>php %command.full_name% fichier.csv --dry-run</info>
      Simule l'import sans modifier les données

  <info>php %command.full_name% fichier.csv -o valeur --force</info>
      Import forcé avec option
HELP
            );
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);

        // Récupérer les arguments et options
        $arg1 = $input->getArgument('arg1');
        $isDryRun = $input->getOption('dry-run');
        $force = $input->getOption('force');

        // Afficher le header
        $io->title('{Command Name}');

        // Demander confirmation si pas --force
        if (!$force && !$io->confirm('Voulez-vous continuer ?', false)) {
            $io->warning('Opération annulée.');
            return Command::SUCCESS;
        }

        if ($isDryRun) {
            $io->note('Mode dry-run activé - aucune modification ne sera effectuée.');
        }

        try {
            // Logique principale
            $items = $this->getItemsToProcess($arg1);

            // Progress bar
            $progressBar = new ProgressBar($output, count($items));
            $progressBar->setFormat('debug');
            $progressBar->start();

            $processed = 0;
            $errors = [];

            foreach ($items as $item) {
                try {
                    if (!$isDryRun) {
                        $this->service->process($item);
                    }
                    $processed++;
                } catch (\Exception $e) {
                    $errors[] = ['item' => $item, 'error' => $e->getMessage()];
                }
                $progressBar->advance();
            }

            $progressBar->finish();
            $io->newLine(2);

            // Résumé
            $io->success(sprintf('%d éléments traités avec succès.', $processed));

            if (!empty($errors)) {
                $io->warning(sprintf('%d erreurs rencontrées.', count($errors)));
                $io->table(
                    ['Item', 'Erreur'],
                    array_map(fn($e) => [$e['item'], $e['error']], $errors)
                );
            }

            return Command::SUCCESS;

        } catch (\Exception $e) {
            $io->error($e->getMessage());
            return Command::FAILURE;
        }
    }

    private function getItemsToProcess(string $source): array
    {
        // Implémentation selon le besoin
        return [];
    }
}