Changelog Since Symfony 8.0.7

• bug #63812 [DependencyInjection] Fix tagged_iterator/tagged_locator in array PHP config (@javiereguiluz)
• bug #63823 [DependencyInjection] Fix rejecting inline services in parameters section (@nicolas-grekas)
• bug #63817 [Serializer] Fix denormalization of nested array with key types (@mtarld)
• bug #63782 [Serializer] Fix mixed-typed constructor parameters overriding getter-inferred type (@pcescon)
• bug #63818 [Cache] Ensure compatibility with Relay extension 0.21.0 (@lyrixx)
• bug #63806 [Ldap] Make the Adapter resettable (@kira0269, @nicolas-grekas)
• bug #63720 [MonologBridge] Fix ConsoleHandler losing output after nested command terminates (@mp3000mp)
• bug #63723 [EventDispatcher] Fix memory leak in TraceableEventDispatcher for long-running processes (@wazum)
• bug #63749 [Console] Fix performance regression in OutputFormatter for ASCII content (@pcescon)
• bug #63683 [TwigBridge] Fix image method to use DataPart content ID (@pavelwitassek)
• bug #63787 [Serializer] Fix can*() prefix support in GetSetMethodNormalizer (@sn3mdev)
• bug #63747 [Cache] Fix Psr16Cache::getMultiple() returning ValueWrapper with TagAwareAdapter (@pcescon)
• bug #63766 [Dotenv] Fix preloading warning by replacing anonymous exception class (@pcescon)
• bug #63777 [FrameworkBundle] Fix setting router.request_context.base_url when option default_uri is defined (@nicolas-grekas)
• bug #63692 [HttpClient][EventSourceHttpClient] Fix broken streams when first event is delayed (@LachlanArthur)
• bug #63726 [HttpClient] Unset push response content when the push handler is released (@sakozoko)
• bug #63736 [Cache] Fix undefined array key when tag save fails in AbstractTagAwareAdapter (@pcescon)
• bug #63724 [HttpKernel] Fix allowing invalid #[Autowire] references in controller arguments (@valtzu)
• bug #63722 [SecurityBundle] Fix profiler showing ERROR instead of DENIED (@audain-dg)
• bug #63691 [Messenger] Use SignalRegistry::isSupported() in ConsumeMessagesCommand (@shyim)
• bug #63648 [VarDumper] Wrong dumper output for Accept: aplication/json requests (@rfcdt)
• bug #63674 [Dotenv] Fix self-referencing variables with defaults and env key resolution during deferred expansion (@nicolas-grekas)
• bug #63676 [HttpKernel] Reset router locale to default when finishing main request (@guillaumeVDP)
• bug #63679 [WebProfilerBundle] Only decrement pendingRequests when it's more than zero (@andyexeter)
• bug #63655 [Cache] Fix ChainAdapter ignoring item expiry when propagating to earlier adapters (@guillaumeVDP)
• bug #63656 [Form] Fix typed property initialization in ValidatorExtension (@SeverinGloeckle)
• bug #63643 [Messenger] Fix duplicate pending messages in Redis transport with batch handlers (@wazum)
• bug #63639 [ErrorHandler] "@method" deprecation notices are missing when interface inheritance is used (@mpdude)
• bug #63627 [Serializer] Fix self type reference on promoted constructor parameter (@andersonamuller, @nicolas-grekas)
• bug #63635 [VarExporter] Skip rewriting initialized readonly properties during hydration (@nicolas-grekas)
• bug #63629 Fix deprecation notices for "@method" annotations and classes with __call() (@mpdude)
• bug #63624 [JsonStreamer] Fix lazy instantiation for internal PHP classes (@Maxcastel)
• bug #63620 [Dotenv] Fix escaped dollar signs lost during deferred variable resolution (@nicolas-grekas)
• bug #63611 [Process] Throw InvalidArgumentException when env block exceeds Windows limit (Nadim AL ABDOU)
• bug #63616 [HttpKernel] Set propertyPath on MapUploadedFile validation violations (@eyupcanakman)

Changelog Since Symfony 7.4.7

• bug #63812 [DependencyInjection] Fix tagged_iterator/tagged_locator in array PHP config (@javiereguiluz)
• bug #63823 [DependencyInjection] Fix rejecting inline services in parameters section (@nicolas-grekas)
• bug #63817 [Serializer] Fix denormalization of nested array with key types (@mtarld)
• bug #63782 [Serializer] Fix mixed-typed constructor parameters overriding getter-inferred type (@pcescon)
• bug #63818 [Cache] Ensure compatibility with Relay extension 0.21.0 (@lyrixx)
• bug #63806 [Ldap] Make the Adapter resettable (@kira0269, @nicolas-grekas)
• bug #63720 [MonologBridge] Fix ConsoleHandler losing output after nested command terminates (@mp3000mp)
• bug #63723 [EventDispatcher] Fix memory leak in TraceableEventDispatcher for long-running processes (@wazum)
• bug #63749 [Console] Fix performance regression in OutputFormatter for ASCII content (@pcescon)
• bug #63683 [TwigBridge] Fix image method to use DataPart content ID (@pavelwitassek)
• bug #63787 [Serializer] Fix can*() prefix support in GetSetMethodNormalizer (@sn3mdev)
• bug #63747 [Cache] Fix Psr16Cache::getMultiple() returning ValueWrapper with TagAwareAdapter (@pcescon)
• bug #63766 [Dotenv] Fix preloading warning by replacing anonymous exception class (@pcescon)
• bug #63777 [FrameworkBundle] Fix setting router.request_context.base_url when option default_uri is defined (@nicolas-grekas)
• bug #63692 [HttpClient][EventSourceHttpClient] Fix broken streams when first event is delayed (@LachlanArthur)
• bug #63726 [HttpClient] Unset push response content when the push handler is released (@sakozoko)
• bug #63736 [Cache] Fix undefined array key when tag save fails in AbstractTagAwareAdapter (@pcescon)
• bug #63724 [HttpKernel] Fix allowing invalid #[Autowire] references in controller arguments (@valtzu)
• bug #63722 [SecurityBundle] Fix profiler showing ERROR instead of DENIED (@audain-dg)
• bug #63691 [Messenger] Use SignalRegistry::isSupported() in ConsumeMessagesCommand (@shyim)
• bug #63648 [VarDumper] Wrong dumper output for Accept: aplication/json requests (@rfcdt)
• bug #63674 [Dotenv] Fix self-referencing variables with defaults and env key resolution during deferred expansion (@nicolas-grekas)
• bug #63676 [HttpKernel] Reset router locale to default when finishing main request (@guillaumeVDP)
• bug #63679 [WebProfilerBundle] Only decrement pendingRequests when it's more than zero (@andyexeter)
• bug #63655 [Cache] Fix ChainAdapter ignoring item expiry when propagating to earlier adapters (@guillaumeVDP)
• bug #63656 [Form] Fix typed property initialization in ValidatorExtension (@SeverinGloeckle)
• bug #63643 [Messenger] Fix duplicate pending messages in Redis transport with batch handlers (@wazum)
• bug #63639 [ErrorHandler] "@method" deprecation notices are missing when interface inheritance is used (@mpdude)
• bug #63627 [Serializer] Fix self type reference on promoted constructor parameter (@andersonamuller, @nicolas-grekas)
• bug #63635 [VarExporter] Skip rewriting initialized readonly properties during hydration (@nicolas-grekas)
• bug #63629 Fix deprecation notices for "@method" annotations and classes with __call() (@mpdude)
• bug #63624 [JsonStreamer] Fix lazy instantiation for internal PHP classes (@Maxcastel)
• bug #63620 [Dotenv] Fix escaped dollar signs lost during deferred variable resolution (@nicolas-grekas)
• bug #63611 [Process] Throw InvalidArgumentException when env block exceeds Windows limit (Nadim AL ABDOU)
• bug #63616 [HttpKernel] Set propertyPath on MapUploadedFile validation violations (@eyupcanakman)

Changelog Since Symfony 6.4.35

• bug #63823 [DependencyInjection] Fix rejecting inline services in parameters section (@nicolas-grekas)
• bug #63817 [Serializer] Fix denormalization of nested array with key types (@mtarld)
• bug #63818 [Cache] Ensure compatibility with Relay extension 0.21.0 (@lyrixx)
• bug #63806 [Ldap] Make the Adapter resettable (@kira0269, @nicolas-grekas)
• bug #63720 [MonologBridge] Fix ConsoleHandler losing output after nested command terminates (@mp3000mp)
• bug #63723 [EventDispatcher] Fix memory leak in TraceableEventDispatcher for long-running processes (@wazum)
• bug #63749 [Console] Fix performance regression in OutputFormatter for ASCII content (@pcescon)
• bug #63683 [TwigBridge] Fix image method to use DataPart content ID (@pavelwitassek)
• bug #63787 [Serializer] Fix can*() prefix support in GetSetMethodNormalizer (@sn3mdev)
• bug #63747 [Cache] Fix Psr16Cache::getMultiple() returning ValueWrapper with TagAwareAdapter (@pcescon)
• bug #63766 [Dotenv] Fix preloading warning by replacing anonymous exception class (@pcescon)
• bug #63777 [FrameworkBundle] Fix setting router.request_context.base_url when option default_uri is defined (@nicolas-grekas)
• bug #63692 [HttpClient][EventSourceHttpClient] Fix broken streams when first event is delayed (@LachlanArthur)
• bug #63726 [HttpClient] Unset push response content when the push handler is released (@sakozoko)
• bug #63736 [Cache] Fix undefined array key when tag save fails in AbstractTagAwareAdapter (@pcescon)
• bug #63724 [HttpKernel] Fix allowing invalid #[Autowire] references in controller arguments (@valtzu)
• bug #63691 [Messenger] Use SignalRegistry::isSupported() in ConsumeMessagesCommand (@shyim)
• bug #63674 [Dotenv] Fix self-referencing variables with defaults and env key resolution during deferred expansion (@nicolas-grekas)
• bug #63676 [HttpKernel] Reset router locale to default when finishing main request (@guillaumeVDP)
• bug #63679 [WebProfilerBundle] Only decrement pendingRequests when it's more than zero (@andyexeter)
• bug #63655 [Cache] Fix ChainAdapter ignoring item expiry when propagating to earlier adapters (@guillaumeVDP)
• bug #63656 [Form] Fix typed property initialization in ValidatorExtension (@SeverinGloeckle)
• bug #63643 [Messenger] Fix duplicate pending messages in Redis transport with batch handlers (@wazum)
• bug #63639 [ErrorHandler] "@method" deprecation notices are missing when interface inheritance is used (@mpdude)
• bug #63635 [VarExporter] Skip rewriting initialized readonly properties during hydration (@nicolas-grekas)
• bug #63629 Fix deprecation notices for "@method" annotations and classes with __call() (@mpdude)
• bug #63620 [Dotenv] Fix escaped dollar signs lost during deferred variable resolution (@nicolas-grekas)

A Full Widget Toolkit for the Terminal

Tui ships with a complete set of widgets:

• TextWidget for labels, headings, and FIGlet ASCII art banners
• InputWidget for single-line text fields with cursor, scrolling, and paste support
• EditorWidget, a full multi-line text editor with word wrap, undo/redo, a kill ring, and autocomplete
• SelectListWidget for scrollable, filterable pick lists
• SettingsListWidget for preference panels with value cycling and submenus
• TabsWidget for multi-view interfaces with horizontal or vertical headers (follow-up PR)
• MarkdownWidget with full CommonMark support and syntax-highlighted code blocks
• ImageWidget and AnimatedImageWidget for inline images (via the Kitty graphics protocol) and animated GIF playback as ASCII art (follow-up PR)
• OverlayWidget for modal dialogs, dropdowns, and floating panels (follow-up PR)
• LoaderWidget, CancellableLoaderWidget, and ProgressBarWidget for background operations

Every widget supports padding, borders (with 9 built-in patterns like rounded, double, and block styles), backgrounds, text decoration, and alignment. Widgets compose into trees using ContainerWidget with vertical or horizontal layout, gaps, and vertical expansion.

CSS-like Styling

Tui's styling system draws heavily from CSS. Styles are immutable value objects with properties for colors (ANSI, 256-palette, true color RGB with mix(), tint(), and shade()), text formatting, padding, borders, layout direction, gaps, and alignment.

There are three ways to style a widget:

Stylesheet rules with CSS-like selectors (universal, FQCN, class, state, sub-elements, responsive breakpoints):

$stylesheet->addRule('.sidebar:focused', new Style(
    border: Border::all(1, 'rounded', 'cyan'),
));

$stylesheet->addRule(MarkdownWidget::class.'::code-block-border', new Style(
    color: 'gray',
));

Tailwind-like utility classes for quick, composable styling:

$widget->addStyleClass('p-2');
$widget->addStyleClass('bg-emerald-500');
$widget->addStyleClass('bold');
$widget->addStyleClass('border-rounded');

The full Tailwind shade palette is supported: text-blue-700, bg-rose-100, border-cyan-400, and so on.

Inline styles for one-off overrides with the highest cascade priority.

The cascade merges these layers exactly like CSS: stylesheet rules, then utility classes, then inline styles. Responsive breakpoints let you switch layouts based on terminal width, just like @media queries.

Declarative Templates with Twig (follow-up PR)

Tui includes a template system that lets you describe widget trees using pseudo-HTML and Twig. Structure lives in templates, styling in stylesheets, and behavior in PHP:

{% extends "layout.html.twig" %}

{% block content %}
    <text>Pick a language:</text>
    <select-list id="list" max-visible="5">
        <item value="php" label="PHP" description="Hypertext Preprocessor"></item>
        <item value="python" label="Python" description="Simple and powerful"></item>
        <item value="rust" label="Rust" description="Memory safety without GC"></item>
    </select-list>
{% endblock %}

Templates support Twig inheritance, blocks, loops, conditionals, and custom widget tags via namespace prefixes. You get the same separation of concerns you're used to in web development: Twig for structure, stylesheets for presentation, PHP for behavior.

Powered by PHP Fibers

Under the hood, Tui runs on PHP Fibers and the Revolt event loop. This means the entire application is single-threaded but fully concurrent, with no extensions required: pure PHP 8.4+.

What does this enable? Animations keep running while you type. The loader spinner keeps spinning during HTTP requests. Input is never blocked by rendering. Multiple async operations run in parallel. The Amp ecosystem provides non-blocking replacements for HTTP, processes, and timers that integrate seamlessly since they share the same event loop.

Smart Rendering

The rendering pipeline is engineered for performance:

• Dirty tracking: widgets self-invalidate; only dirty subtrees are re-rendered
• Render cache: unchanged widgets return cached output, skipping style resolution, layout, chrome, and content rendering entirely
• Screen diffing: only changed cells are written to the terminal, minimizing I/O
• Compositing: multiple layers (transparent or opaque) can be merged, useful for animated backgrounds with text on top

The result: smooth rendering, efficient enough for real-time games.

Mouse, Focus, Keybindings, Events

Tui supports the full range of interaction patterns you'd expect from a modern UI toolkit:

• Mouse support (follow-up PR): click to focus, click to place cursors, scroll wheels, drag, click-outside dismissal for overlays. Hold Shift to bypass mouse tracking for native text selection.
• Focus management: F6/Shift+F6 cycling, programmatic focus, :focused state for conditional styling.
• Customizable keybindings: a three-layer merge system (widget defaults, app-level, per-widget overrides) so you can remap any action without subclassing.
• Event system: built on Symfony EventDispatcher with per-widget listeners, global listeners, and typed events (SubmitEvent, SelectEvent, ChangeEvent, CancelEvent, TabChangeEvent, FocusEvent, and more).

FIGlet Fonts

Tui bundles five FIGlet fonts (big, small, slant, standard, mini) and makes it trivial to register your own via FontRegistry. Apply a font with a Tailwind utility class (font-big) or a stylesheet rule, and TextWidget renders your text as large ASCII art. For the keynote where I first presented Tui, I created custom FIGlet fonts (chisel, VGA, minecraft, rounded, slanted) to make the slides look great, all rendered live in the terminal.

Real-World: Already in Production

Tui isn't a toy. It already powers my very own AI coding agent built entirely on the component: an editor widget for code input, markdown rendering for AI responses, streaming output via fibers, overlays for model selection, tabs for multiple conversations, mouse support, customizable keybindings, and themes.

The Tui integrates naturally with Symfony Console: create a Tui inside a command's execute() method, run it, and return the exit code. After run() returns, the terminal is restored and you can use the Console output object normally.

What's Next

I've just opened the pull request on github.com/symfony/symfony. I can't wait to see what the community builds with it.

The terminal has always been my favorite playground. With Tui, I hope it becomes yours too.

The html_attr function

Building HTML attributes in templates has always been tedious: you need to handle escaping, conditional attributes, merging CSS classes, and boolean attributes like disabled or required. The new html_attr function takes care of all of that:

<div {{ html_attr({class: ['btn', 'btn-primary'], id: 'submit'}) }}>
    Click me
</div>

{# Output: <div class="btn btn-primary" id="submit">Click me</div> #}

The function accepts multiple attribute maps, merging them automatically. Boolean values, null, and aria-*/data-* attributes are handled with sensible defaults: false and null omit the attribute, true prints the attribute with an empty value, and aria-* attributes render "true"/"false" strings as expected by the spec:

{% set base = {class: ['btn']} %}
{% set variant = {class: ['btn-primary'], disabled: true} %}

<button {{ html_attr(base, variant) }}>Submit</button>

{# Output: <button class="btn btn-primary" disabled="">Submit</button> #}

Two companion filters are also available: html_attr_merge to merge attribute maps without rendering them, and html_attr_type to handle multi-valued attributes like comma-separated srcset or sizes (thanks to @mpdude and @polarbirke).

See #3930.

The html_attr_relaxed escaping strategy

Some front-end frameworks like Vue.js use special characters in attribute names: :checked, @click, v-bind:[prop]. The standard html_attr escaping strategy encodes these characters, breaking the framework integration. The new html_attr_relaxed strategy keeps :, @, [, and ] unescaped while still protecting against injection:

<input {{ html_attr({':disabled': 'isLoading', '@input': 'validate'})|e('html_attr_relaxed') }}>

{# Output: <input :disabled="isLoading" @input="validate"> #}

This strategy is also used internally by the html_attr function for attribute names (thanks to @mpdude).

See #4743.

Short-circuiting in null-safe operator chains

The null-safe operator (?.) now properly short-circuits the entire chain when null is encountered, matching the behavior of PHP, Symfony PropertyAccess, and the ExpressionLanguage component. Previously, only the immediate access was guarded, so user?.address.city would still try to access .city on the null result. Now, the rest of the chain is skipped:

{{ user?.address.city }}
{# Returns null if user is null; address.city is not evaluated #}

This makes null-safe chains much safer and more predictable (thanks to @HypeMC).

See #4748.

Renaming variables in object destructuring

Object destructuring, introduced in Twig 3.23, now supports renaming variables using the key: variable syntax. The key is the property to extract, and the variable is the local name to assign it to, just like JavaScript:

{% do {name: userName, email: userEmail} = user %}

{{ userName }}   {# user.name #}
{{ userEmail }}  {# user.email #}

This is especially useful when destructuring multiple objects that share the same property names:

{% do {data: product, error: productError} = loadProduct() %}
{% do {data: stock, error: stockError} = loadStock() %}

See #4759.

Full Changelog

• #3930 Add an html_attr function to make outputting HTML attributes easier (@mpdude, @polarbirke)
• #4778 Fix null coalescing operator with imported macros (@fabpot)
• #4775 Add getOperatorTokens() to ExpressionParserInterface to separate operator token registration from parser identity (@fabpot)
• #4774 Ensure filters/attributes aren't mistaken for operators (@brandonkelly)
• #4771 Deprecate passing non AbstractExpression nodes to MatchesBinary (@fabpot)
• #4769 Deprecate passing a non-AbstractExpression node to Parser::setParent() (@fabpot)
• #4759 Add support for renaming variables in object destructuring (@fabpot)
• #4748 Support short-circuiting in null-safe operator chains (@HypeMC)
• #4743 Add html_attr_relaxed escaping strategy (@mpdude)