NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4 most downloaded on Packagist
Eases the creation of beautiful and testable command line interfaces
Latest stable
v8.1.11
Last release 16 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Rarely documented
notes for 1 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
793 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
Changelog ( v8.2.0-BETA1...v8.2.0-BETA2 )
Changelog (v8.2.0-BETA1...v8.2.0-BETA2)
minor #67499 Warn about deprecated options passed by their negation or any of their shortcuts ( @jack-worman )
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Changelog (v8.1.11...v8.2.0-BETA1)
command.invocation and migrate command examples (@nicolas-grekas)suggestPaths() and suggestDirectories() to let the shell complete paths (@nicolas-grekas)LockableTrait::lock() (@HypeMC)# groups and let the attribute list options (@nicolas-grekas)listedAt option to list a command only from a given verbosity" (@MatTheCat)gitlab output format to the lint:yaml command (@revoltek-daniel)#, # and # (@MacDada)listedAt option to list a command only from a given verbosity (@jprivet-dev)Changelog ( v8.1.10...v8.1.11 )
Changelog (v8.1.10...v8.1.11)
setRow(), setColumnMaxWidth() and consecutive rowspans in Table (@nicolas-grekas)Table cells that span rows when they follow a cell that spans columns (@ybai08)[SECURITY] Security release
bug #67575 Fix raw token stripping when an option value matches the command ( @ahbaqdadi )
Changelog (v8.1.9...v8.1.10)
Table header cells that span rows and escaped tags in TableCell (@nicolas-grekas)Table cells and newlines around style tags (@nicolas-grekas)Table cells (@nicolas-grekas)Helper::removeDecoration() keeping escaped > and trailing backslashes (@nicolas-grekas)< or > (@nicolas-grekas)[SECURITY] Security release
bug #66863 Fix the usages of invokable commands registered as services (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.1.8...v8.1.9)
DateTimeValueResolver (@nicolas-grekas)bug #66141 Fix quadratic formatting of non-ASCII content (@a-muzyka)
Changelog (https://github.com/symfony/console/compare/v8.1.7...v8.1.8)
bug #66031 Report a validation error instead of a TypeError on numeric arguments and options (@tanguychenier)
Changelog (https://github.com/symfony/console/compare/v8.1.6...v8.1.7)
# on both a class and its __invoke() method (@nicolas-grekas)# names relative to the class-level one (@nicolas-grekas)bug #65692 Escape context strings written to the terminal (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.1.5...v8.1.6)
bug #65367 Fix PHP 8.6 deprecations (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.1.4...v8.1.5)
# attribute on arguments of invokable commands (@HypeMC)bug #65065 Fix column widths when a row spans columns (@wazum)
Changelog (https://github.com/symfony/console/compare/v8.1.2...v8.1.4)
bug #64662 Decorate stdout and stderr independently when a formatter is injected (@jprivet-dev)
Changelog (https://github.com/symfony/console/compare/v8.1.1...v8.1.2)
minor #64614 use mb_convert_encoding() instead of mb_convert_variables() (@Girgias)
Changelog (https://github.com/symfony/console/compare/v8.1.0...v8.1.1)
Changelog (https://github.com/symfony/console/compare/v8.1.0-RC1...v8.1.0) * no significant changes
Changelog (https://github.com/symfony/console/compare/v8.1.0-RC1...v8.1.0)
ConsoleBundle for console applications with DI, autodiscovery and autowiringSymfonyStyle blocks with the ECH ANSI sequence on decorated outputs so trailing cells are excluded from copy selections$container parameter to Application for automatic service wiring from a PSR containerSymfonyStyle::outlineBlock() and convenience methods outlineSuccess(), outlineError(), outlineWarning(), outlineNote(), outlineInfo(), outlineCaution() for border-only message blocks with the type label embedded in the top borderTraceableValueResolver to help inspecting value resolvers performancesobject support to input options and arguments' default by changing the $default type to mixed in InputArgument, InputOption, #[Argument] and #[Option]#[Ask] on InputFile types, supporting Kitty Graphics and iTerm2 protocolsFileQuestion, InputFile, InputFileValueResolver, and SymfonyStyle::askFile() for file input handlingQuestion::setConstraints() and ValidateQuestionInputListener to validate question input using Validator constraints#[AskChoice] attribute for interactive choice questions in invokable commands#[AsCommand] attributeBackedEnum and DateTimeInterface support to #[MapInput]#[MapInput] along with optional validationGroups to control which groups are validatedTesterTrait::assertCommandFailed() to test commandTesterTrait::assertCommandIsInvalid() to test commandCommandTester::run(), ExecutionResult, and ConsoleAssertionsTrait to assert output and error streams together$format argument to SymfonyStyle::createProgressBar(), SymfonyStyle::progressStart(), and SymfonyStyle::progressIterate() to allow passing a custom ProgressBar format stringInputOption::VALUE_NEGATABLE optionsInputArgument::REQUIRED and InputArgument::OPTIONAL modes to InputArgument constructorInputOption::VALUE_NONE, InputOption::VALUE_REQUIRED and InputOption::VALUE_OPTIONAL modes to InputOption constructorRawInputInterface to expose the original arguments and options and to unparse options, implemented by Inputbug #64355 Format message in ConsoleSectionOutput::overwrite() (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.1.0-BETA3...v8.1.0-RC1)
bug #64246 Various fixes and hardenings (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.1.0-BETA2...v8.1.0-BETA3)
bug #64182 Fix signal handler scoping (@jpollard3)
Changelog (https://github.com/symfony/console/compare/v8.1.0-BETA1...v8.1.0-BETA2)
ConsoleSectionOutput::overwrite() atomic to fix sections + ProgressIndicator clear (@Amoifr)symfony/polyfill-php85 dependency (@Amoifr)feature #52055 Deprecate combining incompatible mode flags in InputArgument and InputOption (@jnoordsij)
Changelog (https://github.com/symfony/console/compare/v8.0.13...v8.1.0-BETA1)
ConsoleSectionOutput::overwrite() atomic to fix sections + ProgressIndicator clear (@Amoifr)# service references in command arguments (@ruudk)# (@chalasr)Application (@nicolas-grekas)InputArgument and InputOption (@jnoordsij)InputOption::VALUE_NEGATABLE options (@jnoordsij)CommandTester (@theofidry)QuestionHelper and # (@chalasr)QuestionHelper and # (@chalasr)# attribute for interactive choice questions (@yceruto)bug #64662 Decorate stdout and stderr independently when a formatter is injected (@jprivet-dev)
Changelog (https://github.com/symfony/console/compare/v8.0.14...v8.0.15)
minor #64614 use mb_convert_encoding() instead of mb_convert_variables() (@Girgias)
Changelog (https://github.com/symfony/console/compare/v8.0.13...v8.0.14)
bug #64355 Format message in ConsoleSectionOutput::overwrite() (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.0.11...v8.0.13)
bug #64182 Fix signal handler scoping (@jpollard3)
Changelog (https://github.com/symfony/console/compare/v8.0.9...v8.0.11)
ConsoleSectionOutput::overwrite() atomic to fix sections + ProgressIndicator clear (@Amoifr)bug #63859 Fix shell completion when SHELL_VERBOSITY=-1 (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.0.8...v8.0.9)
bug #63749 Fix performance regression in OutputFormatter for ASCII content (@pcescon)
Changelog (https://github.com/symfony/console/compare/v8.0.7...v8.0.8)
bug #63604 Fix ApplicationTester ignoring interactive and verbosity options when SHELL_VERBOSITY is set (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v8.0.6...v8.0.7)
ApplicationTester ignoring interactive and verbosity options when SHELL_VERBOSITY is set (@nicolas-grekas)bug #47432 Fix various completion edge cases (@Seldaek)
Changelog (https://github.com/symfony/console/compare/v8.0.5...v8.0.6)
# wrongly considered null in profiler (@chalasr)# (@chalasr)remaining and estimated placeholder guards (@yoeunes)Changelog (https://github.com/symfony/console/compare/v8.0.3...v8.0.4) * no significant changes
Changelog (https://github.com/symfony/console/compare/v8.0.3...v8.0.4)
bug symfony/symfony#62813 [Console] Fix EofShortcut instruction when using a modern terminal on Windows (@fperxas)
Changelog (https://github.com/symfony/console/compare/v8.0.2...v8.0.3)
bug symfony/symfony#61962 [Console] Handle signals on text input (@valx76)
Changelog (https://github.com/symfony/console/compare/v8.0.0...v8.0.1)
--help option when a command is not found (@santysisi)Changelog (https://github.com/symfony/console/compare/v8.0.0-RC3...v8.0.0) * no significant changes
Changelog (https://github.com/symfony/console/compare/v8.0.0-RC3...v8.0.0)
AsCommand attribute class finalCommand::getDefaultName() and Command::getDefaultDescription() in favor of the #[AsCommand] attributeCommand::setCode() method have proper parameter and return typesisSilent() to OutputInterfaceSymfony\Component\Console\Application::add() method in favor of Symfony\Component\Console\Application::addCommand()$finishedIndicator to ProgressIndicator::finish()bug symfony/symfony#62416 [Console] Fix completion for global options values (@HypeMC)
Changelog (https://github.com/symfony/console/compare/v8.0.0-RC2...v8.0.0-RC3)
Changelog (https://github.com/symfony/console/compare/v8.0.0-RC1...v8.0.0-RC2) * no significant changes
Changelog (https://github.com/symfony/console/compare/v8.0.0-RC1...v8.0.0-RC2)
bug symfony/symfony#62335 [Console] Fix signal handlers not being cleared after command termination (@yoeunes)
Changelog (https://github.com/symfony/console/compare/v8.0.0-BETA2...v8.0.0-RC1)
Changelog (https://github.com/symfony/console/compare/v8.0.0-BETA1...v8.0.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/console/compare/v8.0.0-BETA1...v8.0.0-BETA2)
feature symfony/symfony#60776 [Console][FrameworkBundle] Remove deprecated Application::add() methods (@HypeMC)
Changelog (https://github.com/symfony/console/compare/v7.3.4...v8.0.0-BETA1)
Cursor helper in invokable commands (@yceruto)#[Interact] and #[Ask] attributes (@yceruto)#[Input] attribute to support DTOs in invokable commands (@yceruto)#[AsCommand] attribute class final (@OskarStark)CommandTester (@ruudk)Application::add() methods (@HypeMC)BackedEnum in invokable commands (@GromNaN)Changelog ( v7.4.22...v7.4.23 )
Changelog (v7.4.22...v7.4.23)
setRow(), setColumnMaxWidth() and consecutive rowspans in Table (@nicolas-grekas)Table cells that span rows when they follow a cell that spans columns (@ybai08)[SECURITY] Security release
Changelog ( v7.4.21...v7.4.22 )
Changelog (v7.4.21...v7.4.22)
Table header cells that span rows and escaped tags in TableCell (@nicolas-grekas)Table cells and newlines around style tags (@nicolas-grekas)Table cells (@nicolas-grekas)< or > (@nicolas-grekas)[SECURITY] Security release
bug #66863 Fix the usages of invokable commands registered as services (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.20...v7.4.21)
bug #66141 Fix quadratic formatting of non-ASCII content (@a-muzyka)
Changelog (https://github.com/symfony/console/compare/v7.4.19...v7.4.20)
bug #66031 Report a validation error instead of a TypeError on numeric arguments and options (@tanguychenier)
Changelog (https://github.com/symfony/console/compare/v7.4.18...v7.4.19)
bug #65692 Escape context strings written to the terminal (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.17...v7.4.18)
bug #65367 Fix PHP 8.6 deprecations (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.16...v7.4.17)
bug #65065 Fix column widths when a row spans columns (@wazum)
Changelog (https://github.com/symfony/console/compare/v7.4.15...v7.4.16)
bug #64662 Decorate stdout and stderr independently when a formatter is injected (@jprivet-dev)
Changelog (https://github.com/symfony/console/compare/v7.4.14...v7.4.15)
minor #64614 use mb_convert_encoding() instead of mb_convert_variables() (@Girgias)
Changelog (https://github.com/symfony/console/compare/v7.4.13...v7.4.14)
bug #64355 Format message in ConsoleSectionOutput::overwrite() (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.11...v7.4.13)
bug #64182 Fix signal handler scoping (@jpollard3)
Changelog (https://github.com/symfony/console/compare/v7.4.9...v7.4.11)
ConsoleSectionOutput::overwrite() atomic to fix sections + ProgressIndicator clear (@Amoifr)bug #63859 Fix shell completion when SHELL_VERBOSITY=-1 (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.8...v7.4.9)
bug #63749 Fix performance regression in OutputFormatter for ASCII content (@pcescon)
Changelog (https://github.com/symfony/console/compare/v7.4.7...v7.4.8)
bug #63604 Fix ApplicationTester ignoring interactive and verbosity options when SHELL_VERBOSITY is set (@nicolas-grekas)
Changelog (https://github.com/symfony/console/compare/v7.4.6...v7.4.7)
ApplicationTester ignoring interactive and verbosity options when SHELL_VERBOSITY is set (@nicolas-grekas)bug #47432 Fix various completion edge cases (@Seldaek)
Changelog (https://github.com/symfony/console/compare/v7.4.5...v7.4.6)
# wrongly considered null in profiler (@chalasr)# (@chalasr)remaining and estimated placeholder guards (@yoeunes)Changelog (https://github.com/symfony/console/compare/v7.4.3...v7.4.4) * no significant changes
Changelog (https://github.com/symfony/console/compare/v7.4.3...v7.4.4)
bug symfony/symfony#62813 [Console] Fix EofShortcut instruction when using a modern terminal on Windows (@fperxas)
Changelog (https://github.com/symfony/console/compare/v7.4.2...v7.4.3)
bug symfony/symfony#61962 [Console] Handle signals on text input (@valx76)
Changelog (https://github.com/symfony/console/compare/v7.4.0...v7.4.1)
--help option when a command is not found (@santysisi)bug symfony/symfony#62493 [Console] Fix exception message when abbreviation matches multiple hidden commands (@yoeunes)
Changelog (https://github.com/symfony/console/compare/v7.4.0-RC3...v7.4.0)
Command::getCode() to get the code set via setCode()Symfony\Component\Console\Application::addCommand() to simplify using invokable commands when the component is used standaloneSymfony\Component\Console\Application::add() in favor of Symfony\Component\Console\Application::addCommand()BackedEnum support with #[Argument] and #[Option] inputs in invokable commands#[AsCommand] attribute.Symfony\Component\Console\Tester\CommandTester#[MapInput] attribute to support DTOs in commandsQuestionHelper#[Interact] and #[Ask] attributesCursor helper in invokable commandsbug symfony/symfony#62416 [Console] Fix completion for global options values (@HypeMC)
Changelog (https://github.com/symfony/console/compare/v7.4.0-RC2...v7.4.0-RC3)
Changelog (https://github.com/symfony/console/compare/v7.4.0-RC1...v7.4.0-RC2) * no significant changes
Changelog (https://github.com/symfony/console/compare/v7.4.0-RC1...v7.4.0-RC2)
bug symfony/symfony#62335 [Console] Fix signal handlers not being cleared after command termination (@yoeunes)
Changelog (https://github.com/symfony/console/compare/v7.4.0-BETA2...v7.4.0-RC1)
Changelog (https://github.com/symfony/console/compare/v7.4.0-BETA1...v7.4.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/console/compare/v7.4.0-BETA1...v7.4.0-BETA2)
feature symfony/symfony#62068 [Console] Add support for Cursor helper in invokable commands (@yceruto)
Changelog (https://github.com/symfony/console/compare/v7.3.4...v7.4.0-BETA1)
Cursor helper in invokable commands (@yceruto)#[Interact] and #[Ask] attributes (@yceruto)#[Input] attribute to support DTOs in invokable commands (@yceruto)CommandTester (@ruudk)BackedEnum in invokable commands (@GromNaN)Changelog (https://github.com/symfony/console/compare/v7.3.9...v7.3.10) * no significant changes
Changelog (https://github.com/symfony/console/compare/v7.3.9...v7.3.10)
One column per quarter.