Command-Line Tools: Symfony/Console

The next time you run composer require or php artisan migrate, you’re using Symfony’s Console component. Both Composer and Laravel’s Artisan are built on it. None of that requires the rest of the Symfony framework; Console is a standalone package that turns a PHP class into a proper command-line tool with arguments, options, colored output, and progress bars, with nothing else attached.

composer require symfony/console

<?php
// bin/console
require __DIR__.'/../vendor/autoload.php';

use Symfony\Component\Console\Application;
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 ImportUsersCommand extends Command
{
    protected static $defaultName = 'app:import-users';

    protected function configure(): void
    {
        $this->addArgument('file', InputArgument::REQUIRED, 'Path to the CSV file');
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $rows = array_map('str_getcsv', file($input->getArgument('file')));
        $output->writeln(sprintf('<info>Imported %d rows.</info>', count($rows)));

        return Command::SUCCESS;
    }
}

$app = new Application('My Tool', '1.0.0');
$app->add(new ImportUsersCommand());
$app->run();

php bin/console app:import-users users.csv

When to reach for this

Any time the job is a script someone will run by hand or from a cron entry: a data import, a cleanup task, a deploy step. It’s a better foundation than a raw PHP script the moment you need arguments, flags, or output that a human has to read and trust.

When it’s the wrong fit

If the “script” is really the beginning of a web application, or if you’re already inside a Laravel or Symfony project, use artisan or the app’s own bin/console instead of bootstrapping a second, separate command-line entry point.

Under the hood: Console commands are ordinary PHP classes with a configure() and an execute() method. There’s no special runtime, no compiled binary, just the same PHP interpreter you already have, pointed at a script instead of a browser request.