Symfony Blog

New in Symfony 8.1: DX Improvements (Part 1)

Javier Eguiluz — Wed, 10 Jun 2026 08:35:00 +0200

Every Symfony release ships dozens of small developer experience (DX) improvements that make day-to-day work more pleasant. This article highlights some of those improvements in Symfony 8.1.

Copy Requests as cURL Commands

Contributed by Sylvain Combraque in #62320

When debugging an issue, you often need to replay a request outside the browser to tweak it or share it with a colleague. The profiler already shows every detail of the request, but rebuilding a curl command by hand from its headers, cookies, and body is tedious and error-prone.

Symfony 8.1 adds a "Copy as cURL" button to the Request/Response tab of the profiler. It generates a ready-to-run command that includes the HTTP method, full URL, request headers, cookies, and body for write requests. Paste it into your terminal to reproduce the exact same request in seconds.

Contributed by Martin Gilbert in #63943

The Web Debug Toolbar revealed its panels only on mouse hover, making the information within them inaccessible to keyboard and screen reader users.

Symfony 8.1 makes the toolbar fully keyboard-navigable and adds the WAI-ARIA semantics that assistive technologies rely on. You can now move between items with the arrow keys, open a panel with the Down arrow, and close it with Escape. Panels also open on keyboard focus, not just on hover, and each item exposes a descriptive label and the proper toolbar and dialog roles.

Sorting Routes in the `debug:router` Command

Contributed by Michaël Thieulin in #63905

The debug:router command lists routes in the order Symfony evaluates them, making it hard to locate a specific route in a large application. Sorting the list meant piping the output through tools like sort, which broke the clickable links to the route definitions.

Symfony 8.1 adds a --sort option to sort routes by any column: name, path, method, scheme, or host:

        
        $ php bin/console debug:router --sort=path

# the option is case-insensitive and works for all output formats
$ php bin/console debug:router --sort=name --format=json

Sorting Scheduled Messages by Next Run Date

Contributed by yoann aparici in #63135

When you have many scheduled tasks, the debug:scheduler command lists them in the order they were defined, making it hard to tell which one runs next or spot tasks that fire at the same time.

Symfony 8.1 adds a --sort option that orders recurring messages by their next run date, so the task that runs soonest appears first:

$ php bin/console debug:scheduler --sort

Matching Transport Names with Regular Expressions

Contributed by Santiago San Martin in #62875

The messenger:consume command expects you to list the transports to consume by their exact names. In applications with many similarly named transports (for example, one transport per scheduler), spelling out every name is tedious.

In Symfony 8.1, the transport names argument also accepts regular expressions, which are matched against configured transport names:

        
        # consume all transports whose name starts with "scheduler_"
$ php bin/console messenger:consume 'scheduler_.*'

# use the (?i) flag for case-insensitive matching
$ php bin/console messenger:consume '(?i)async.*'

# you can still mix regular expressions and explicit names
$ php bin/console messenger:consume 'scheduler_.*' async
    

Each pattern is anchored (it must match the full transport name), and matched transports are consumed in their configuration order. Regular expressions are only supported when the command runs non-interactively.

Mocking Non-Shared Services in Tests

Contributed by HypeMC in #62909

In functional tests, you can replace a service with a test double by calling getContainer()->set(). Until now this only worked for shared services; non-shared services, which are created fresh every time they are requested, could not be replaced.

Symfony 8.1 lifts that restriction. Because a non-shared service returns a new instance on each request, you replace it with a closure that acts as a factory instead of a single object. The closure runs every time the service is fetched:

        
        use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;

class OrderProcessorTest extends KernelTestCase
{
    public function testProcess(): void
    {
        $container = static::getContainer();

        $container->set('app.payment_gateway', function () {
            return $this->createMock(PaymentGateway::class);
        });

        // ...
    }
}
    

Asserting Flash Messages in Tests

Contributed by Alex Rock in #60008

Checking that a controller added a flash message used to require several steps: fetching the request, making sure it has a session, retrieving the flash bag, and inspecting its messages.

Symfony 8.1 replaces all of that with a single assertion called assertSessionHasFlashMessage():

        
        // assert that a flash message of the given type exists
$this->assertSessionHasFlashMessage('success');

// optionally, assert its exact content too
$this->assertSessionHasFlashMessage('success', 'Your changes were saved.');

Controlling Time in Messenger Stamps

Contributed by Mohammad Eftekhari in #62572

The DelayStamp and RedeliveryStamp classes computed time using PHP's native time() function and DateTimeImmutable objects, making any logic that depends on their values impossible to test deterministically.

Symfony 8.1 updates both stamps to rely on the Clock component instead. In your tests, you can now freeze time with MockClock and get fully predictable delays and redelivery timestamps:

        
        use Symfony\Component\Clock\Clock;
use Symfony\Component\Clock\MockClock;
use Symfony\Component\Messenger\Stamp\RedeliveryStamp;

Clock::set(new MockClock('2026-01-01 00:00:00'));

// the stamp now reads the current time from the frozen clock
$stamp = new RedeliveryStamp(retryCount: 1);
    

Sponsor the Symfony project.

SymfonyOnline June 2026: Reconfiguring Symfony in real time with sidekicks

Eloïse Charrier — Tue, 09 Jun 2026 15:00:00 +0200

To wrap up an amazing lineup, SymfonyOnline June 2026 will stream its final expert sessions live online on June 12, 2026.

🎤 Speaker announcement!

Don't miss Nicolas Grekas for the talk "Reconfiguring Symfony in real time with sidekicks":

"PHP was long designed as a strictly stateless language: one request, one process, and then everything starts over.

FrankenPHP fundamentally changes this model by allowing long-running PHP workers to run directly within a Symfony application. Not to turn Symfony into a Node-style server, but to give it capabilities it has never had before.

In this talk, I introduce a new pattern: application sidekicks. These are specialized PHP workers, outside the HTTP lifecycle, that listen to their environment and reconfigure the application in real time; without polling, without approximate TTLs, and without redeployments.

Through concrete use cases (Redis Sentinel discovery, dynamic feature flags, etc.), we’ll see how to evolve an existing Symfony application while staying true to its principles.

The goal: to show that PHP can listen, react, and adapt in real time, without sacrificing its simplicity nor its traditional robustness."

👉 Discover more talks by reading the full schedule

✨ Key Feature: All talks are pre-recorded to ensure the highest technical quality, but speakers will be joining us live to answer your questions in real-time during the dedicated Q&A sessions!

🎟️ Register now!

Join the global PHP & Symfony community from the comfort of your home or office by clicking here.

▶️ Instant Replays: Missed a session? All talks are available for replay as soon as they start.
🆒 Accessibility: English subtitles are provided for all presentations.

We look forward to seeing you online to explore the future of PHP together!

Join us online!

💡Follow the "conference" blog posts to not miss anything!

Want the latest Symfony updates? Follow us and tune in from wherever you are 🌎

Sponsor the Symfony project.

SymfonyOnline June 2026: Coding at the speed of thought: Symfony DX in 2026

Eloïse Charrier — Mon, 08 Jun 2026 14:52:00 +0200

The wait is over! SymfonyOnline June 2026 is coming to you live online on June 11-12, 2026, featuring an incredible lineup of expert speakers.

🎤 Speaker announcement!

We are thrilled to welcome Kévin Dunglas with his talk "Coding at the speed of thought: Symfony DX in 2026":

"Forget everything you know about setting up a PHP development environment. No more complex configurations, Docker permission headaches, or agonizingly slow application cache warmups every time you hit refresh (Sylius, I'm looking at you).

In 2026, FrankenPHP has not only revolutionized production, but it is also totally redefining the Developer Experience (DX) of Symfony.

In this talk, I will show you how we've pushed the boundaries of the application server to offer a fluid, instant, and modern workflow. We will see how to:

Start a project in seconds: A simple command is all it takes to get a fully-featured, standalone environment, complete with automatic HTTPS. Whether you are on Linux or macOS, natively on Windows thanks to the bleeding-edge features of Go 1.26, or using the official Symfony Docker stack with Dev Containers, the experience is unified and immediate.
Get instant feedback (Hot Reloading): Stop hammering the F5 key. FrankenPHP now watches your files and brings true hot reloading to PHP. By dispatching Mercure updates directly to the browser, your app updates on the fly when you change code, just like modern JS frameworks!
Eliminate load times: Worker mode is no longer just for prod. In dev, it keeps your app hot and instantly refreshes the Symfony cache in the background when you save a file in your editor. The result? Pages that are available dramatically faster, reducing wait times even for the heaviest applications.

As a bonus, we'll even see how this new ecosystem seamlessly integrates with AI coding agents like Claude Code inside a fully autonomous, sandboxed environment.

Join me to discover how the power of Go and Caddy, coupled with the flexibility of Symfony, allows you to focus on what matters: your code.

The future of PHP development is here, and it is lightning fast. 🐘🧟⚡️"

👉 Discover more talks by reading the full schedule

✨ Key Feature: All talks are pre-recorded to ensure the highest technical quality, but speakers will be joining us live to answer your questions in real-time during the dedicated Q&A sessions!

🛠️ Pre-conference Workshops (June 9-10)

Don't forget that the conference is preceded by two days of hands-on technical workshops. These small-group sessions are the perfect opportunity to master specific Symfony features under the guidance of certified trainers: Discover the topics!

Note: Workshop spots are limited and no replays are available for these sessions to ensure an interactive learning experience.

🎟️ Register now!

Join the global PHP & Symfony community from the comfort of your home or office by clicking here.

▶️ Instant Replays: Missed a session? All talks are available for replay as soon as they start.
🆒 Accessibility: English subtitles are provided for all presentations.

We look forward to seeing you online to explore the future of PHP together!

Join us online!

💡Follow the "conference" blog posts to not miss anything!

Want the latest Symfony updates? Follow us and tune in from wherever you are 🌎

Sponsor the Symfony project.

SymfonyOnline June 2026: Dealing with audit logs

Eloïse Charrier — Mon, 08 Jun 2026 10:46:00 +0200

Join web developers from all over the world this week for SymfonyOnline June 2026, broadcasting live on June 11-12, 2026.

🎤 Speaker announcement!

We are thrilled to welcome Hubert Lenoir with his talk "Dealing with audit logs":

"Audit logs are essential for compliance, debugging, and security. But setting them up quickly raises real questions: what should we capture? Where to store them? How do we stay GDPR-compliant? How do we avoid leaking sensitive data?

In this talk, we explore how we deal with audit logs in our Symfony projects at SensioLabs: the concrete needs, the classic traps, a tour of the existing bundles, ideas to build a custom audit logger, and how to consume the logs."

👉 Discover more talks by reading the full schedule

✨ Key Feature: All talks are pre-recorded to ensure the highest technical quality, but speakers will be joining us live to answer your questions in real-time during the dedicated Q&A sessions!

🛠️ Pre-conference Workshops (June 9-10)

Note: Workshop spots are limited and no replays are available for these sessions to ensure an interactive learning experience.

🎟️ Register now!

Join the global PHP & Symfony community from the comfort of your home or office by clicking here.

▶️ Instant Replays: Missed a session? All talks are available for replay as soon as they start.
🆒 Accessibility: English subtitles are provided for all presentations.

We look forward to seeing you online to explore the future of PHP together!

Join us online!

💡Follow the "conference" blog posts to not miss anything!

Want the latest Symfony updates? Follow us and tune in from wherever you are 🌎

Sponsor the Symfony project.

A Week of Symfony #1014 (June 1–7, 2026)

Javier Eguiluz — Sun, 07 Jun 2026 09:11:00 +0200

This week, Symfony focused on bug fixes for the recent Symfony 8.1 release. Meanwhile, we published more details about the upcoming SymfonyOnline June 2026 conference.

Symfony development highlights

This week, 39 pull requests were merged (33 in code and 6 in docs) and 20 issues were closed (19 in code and 1 in docs). Excluding merges, 25 authors made 1,845 additions and 5,515 deletions. See details for code and docs.

6.4 changelog:

f55035b: [Mailer] fix inline images in MandrillApiTransport by using the Content-ID as image name
2a1be84: [Notifier] send message to MS-Teams via Workflow
9b185f5: [Form] add missing translation for invalid UUID
a79faa0: [HttpKernel, Security] add allowed_classes => false to unserialize() in CacheWarmerAggregate
d988b22: [Form] translate TranslatableInterface label in violation messages
1be0a58: [Translation] copy domains metadata when moving messages to intl ones
3d7304b: [HttpFoundation] add RFC6598 Shared Address Space to IpUtils::PRIVATE_SUBNETS
6ae13cf: [Webhook] fix Content-Type key in createRequest method
db3c26b: [AssetMapper] render an empty import map as a JSON object

7.4 changelog:

dbda9c2: [Validator] support SVG dimensions with units
3c2e8b9: [Serializer] keep collection value type for iterable constructor parameters

8.1 changelog:

ba829ca: [HttpKernel] fix TypeError in ResponseEvent when argument resolution throws
74fb989: [HttpKernel] fix #[MapRequestPayload] being handled before #[IsGranted]
407b535: [DomCrawler] remove final keyword on ChoiceFormField::addChoice()
683490b: [FrameworkBundle] fix dumping the debug container on cache:clear/cache:warmup
313333c: [HttpKernel] add @template on ControllerAttributeEvent
e5dbdb8: [DependencyInjection] improve TaggedIteratorArgument deprecation warning

Newest issues and pull requests

Symfony Jobs

These are some of the most recent Symfony job offers:

Lead Symfony Developer at DocuPet
Full-time - CA$140,000 – CA$180,000 / year
Full remote
View details
Backend Symfony Developer at KRUU GmbH
Full-time - €60,000 – €75,000 / month
Remote + part-time onsite (Bad Friedrichshall, Germany)
View details
DevOps for a Symfony project at Cloudpepper
Full-time - $150,000 – $180,000 / year
Full remote
View details
Symfony Developer at Design Force Marketing
Full-time - $60,000 – $100,000 / year
Grand Haven Michigan, United States
View details
Backend Symfony Developer at ShipMonk
Contract / Freelance - $5,000 – $8,000 / month
Full remote
View details

You can publish a Symfony job offer for free on symfony.com.

They talked about us

Upcoming Symfony Events

Symfony/PHP Meetup Barcelona by SensioLabs: Barcelona, Spain (June 25, 2026)
Web Summer Camp 2026: Opatija, Croatia (July 2, 2026 – July 4, 2026)

Call to Action

Follow Symfony on X, on Mastodon, on Bluesky and on Threads and share this article.
Subscribe to the Symfony blog RSS and never miss a Symfony story again.

Sponsor the Symfony project.

New in Symfony 8.1: Console Progress and Testing Improvements

Javier Eguiluz — Fri, 05 Jun 2026 12:50:00 +0200

The Console component has been a major focus of Symfony 8.1, and we've already covered a lot of new features in previous articles: improved console input, console argument resolvers, method-based commands, and HTTP-less Symfony applications. This article showcases more console improvements related to styling and testing.

Reporting Progress to the Terminal Taskbar

Contributed by Can Vural in #62112

Modern terminals can display progress information in the window title or taskbar using the OSC 9;4 escape sequence. In Symfony 8.1, progress bars emit this sequence automatically. As soon as a bar starts on a decorated output, the terminal reflects its progress, and finish() or clear() reset it.

Terminals that don't understand the sequence simply ignore it, so this feature works everywhere and requires no configuration. When several progress bars run at the same time, the indicator falls back to an indeterminate state to avoid flickering between unrelated percentages.

If your command prompts the user while a progress bar is running, you can pause the indicator with the static pauseAll() and resumeAll() methods:

        
        use Symfony\Component\Console\Helper\ProgressBar;

ProgressBar::pauseAll();
// ... ask the user something ...
ProgressBar::resumeAll();

This is how it looks in practice:

Customizing the Progress Bar Format

Contributed by Guillaume Van Der Putten in #63443

The SymfonyStyle helper lets you display progress bars with a single method call, but until now you couldn't change their format without creating the bar first and then calling setFormat() on it. Symfony 8.1 adds an optional $format argument to createProgressBar(), progressStart(), and progressIterate(), allowing you to set a custom format in a single step:

        
        // the format is the last argument, after the optional number of steps
foreach ($io->progressIterate($items, null, ' %current%/%max% [%bar%] %memory:6s%') as $item) {
    // ...
}

// the same argument is available when starting a bar manually...
$io->progressStart(100, ' %current%/%max% [%bar%] %memory:6s%');

// ... or when creating a standalone progress bar
$progressBar = $io->createProgressBar(100, ' %current%/%max% [%bar%] %memory:6s%');
    

A Result-Based Testing API for Commands

Contributed by Théo Fidry in #61494

Testing a command that writes to both standard output and standard error previously required the capture_stderr_separately option and two separate calls, which lost the original output ordering. Symfony 8.1 introduces a result-based testing API: the new CommandTester::run() method returns an ExecutionResult object that exposes all three views at once:

        
        use Symfony\Component\Console\Tester\CommandTester;

$result = (new CommandTester($command))->run(['username' => 'Wouter']);

$result->getDisplay();      // stdout and stderr, interleaved
$result->getOutput();       // stdout only
$result->getErrorOutput();  // stderr only
$result->statusCode;        // the command exit code
    

The run() method also accepts interactive answers directly, so you no longer need a separate setInputs() call. Combined with the new ConsoleAssertionsTrait, tests become more expressive:

        
        use PHPUnit\Framework\TestCase;
use Symfony\Component\Console\Tester\ConsoleAssertionsTrait;

class CreateUserCommandTest extends TestCase
{
    use ConsoleAssertionsTrait;

    public function testExecute(): void
    {
        $result = (new CommandTester($command))->run(
            ['username' => '...'],
            interactiveInputs: ['yes'],
        );

        $this->assertIsSuccessful($result);
        $this->assertResultEquals($result, expectedOutput: 'User "..." was created.');
    }
}
    

A Shortcut to Run Commands in Tests

Contributed by Kostiantyn Miakshyn in #63095

Functional tests for commands typically involve a fair amount of boilerplate: booting the kernel, creating the application, finding the command, and wrapping it in a CommandTester. Symfony 8.1 adds the runCommand() shortcut to KernelTestCase, which handles all of this for you and returns a ready-to-use tester:

        
        use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;

class CreateUserCommandTest extends KernelTestCase
{
    public function testExecute(): void
    {
        $commandTester = static::runCommand('app:create-user', [
            'username' => '...',
        ]);

        $commandTester->assertCommandIsSuccessful();
    }
}
    

New Command Status Assertions

Contributed by Damir Mitrovic in #63130

Until now, the console testing traits only provided assertCommandIsSuccessful(). Symfony 8.1 completes the set with two new assertions that explicitly check the other command exit codes:

        
        // asserts the command returned Command::FAILURE
$commandTester->assertCommandFailed();

// asserts the command returned Command::INVALID
$commandTester->assertCommandIsInvalid();

Sponsor the Symfony project.

New in Symfony 8.1: ObjectMapper Improvements

Javier Eguiluz — Thu, 04 Jun 2026 14:52:00 +0200

The ObjectMapper component was introduced in Symfony 7.3 to eliminate the repetitive boilerplate involved in copying data between objects, such as DTOs and entities. Symfony 8.1 builds on that foundation with several improvements that make mappings more expressive and easier to debug.

Define Mappings on the Target Class

Contributed by Florent Blaison in #62522

ObjectMapper typically reads the #[Map(target: ...)] attribute from the source class. In hexagonal or clean architectures, you may prefer to keep domain objects free of mapping metadata. Symfony 8.1 now lets you declare #[Map(source: ...)] on the target class instead:

        
        use App\Domain\Quote;
use Symfony\Component\ObjectMapper\Attribute\Map;

// the mapping lives on the view model, so the Quote domain
// object stays free of any mapping concern
#[Map(source: Quote::class)]
final class QuoteView
{
    public string $id;
    public int $amount;
}
    

Symfony automatically discovers these attributes and builds the class map, so no explicit target class is required when mapping:

        
        public function show(Quote $quote, ObjectMapperInterface $mapper): Response
{
    // Symfony knows Quote maps to QuoteView, so no target is needed
    $view = $mapper->map($quote);

    // ...
}
    

Skip Null Values With the IsNotNull Condition

Contributed by Julien Robic in #63595

When mapping a source object onto an existing target (for example, during a partial "PATCH" update), null values in the source overwrite the target's existing values. Symfony 8.1 adds the built-in IsNotNull condition so you can skip a property whenever its source value is null:

        
        use Symfony\Component\ObjectMapper\Attribute\Map;
use Symfony\Component\ObjectMapper\Condition\IsNotNull;

class UserPatch
{
    public function __construct(
        #[Map(if: new IsNotNull())]
        public ?string $name = null,

        #[Map(if: new IsNotNull())]
        public ?string $email = null,
    ) {
    }
}
    

Mapping new UserPatch('Alice') onto an existing user updates only the name property. The email property is left untouched because its value is null.

Map Collections to a Specific Class

Contributed by Antoine Bluchet in #63024

The MapCollection transform maps an array of source objects into target objects. Until now, each item class required its own #[Map] attribute. Symfony 8.1 adds a targetClass option that lets you declare the destination class directly on the collection:

        
        use Symfony\Component\ObjectMapper\Attribute\Map;
use Symfony\Component\ObjectMapper\Transform\MapCollection;

#[Map(target: Order::class)]
class OrderInput
{
    #[Map(transform: new MapCollection(targetClass: LineItem::class))]
    public array $items = [];
}
    

Each element of $items is mapped to a LineItem instance. This is useful when the same source objects are reused in different contexts and you don't want to add mapping metadata to shared DTOs.

Match Multiple Source and Target Classes

Contributed by Ryan RAJKOMAR in #63383

The TargetClass condition restricts a mapping to specific destination classes. Previously, mapping a property to several target classes required one #[Map] attribute per class. Symfony 8.1 lets you pass an array of class names so a single condition can match any of them:

        
        use Symfony\Component\ObjectMapper\Attribute\Map;
use Symfony\Component\ObjectMapper\Condition\TargetClass;

#[Map(target: PublicProfile::class)]
#[Map(target: AdminProfile::class)]
#[Map(target: AuditProfile::class)]
class User
{
    // map 'lastLoginIp' only when targeting an admin or audit profile
    #[Map(target: 'ip', if: new TargetClass([AdminProfile::class, AuditProfile::class]))]
    public ?string $lastLoginIp = null;
}
    

The same array syntax is supported by the new SourceClass condition, which matches when the source object is an instance of any of the specified classes.

Clearer Errors for Invalid Transform Callables

Contributed by calm329 and Michaël Marinetti in #62957

Previously, if a transform or if callable was misconfigured (for example, a method that didn't exist or a service that didn't implement the expected interface), the value was silently left unmapped, making the issue difficult to diagnose. ObjectMapper now throws a NoSuchCallableException instead:

        
        use Symfony\Component\ObjectMapper\Attribute\Map;

class ProductInput
{
    // 'wrongMethod' is not callable: Symfony 8.1 throws an exception
    // instead of silently skipping the transformation
    #[Map(transform: 'wrongMethod')]
    public string $name = '';
}
    

The exception message explains the problem and reminds you that callable classes must implement TransformCallableInterface (or ConditionCallableInterface for the if option).

Merge Nested Objects Into the Same Target

Contributed by Antoine Bluchet in #62511

Source DTOs are often nested while the target object is flat. When a nested source object maps to the same target class as its parent, ObjectMapper now merges its properties directly into the same target instance, flattening the structure for you:

        
        use Symfony\Component\ObjectMapper\Attribute\Map;

#[Map(target: User::class)]
class UserInput
{
    public string $name;

    // 'address' also maps to User, so its properties are
    // merged into the same User instance
    public AddressInput $address;
}

#[Map(target: User::class)]
class AddressInput
{
    #[Map(target: 'streetName')]
    public string $street;

    public string $city;
}
    

Mapping a UserInput writes street and city from the nested address object into the same User instance alongside name, with no manual flattening required.

Sponsor the Symfony project.

SymfonyOnline June 2026: Symfony 8: The Hexagonal Track

Eloïse Charrier — Thu, 04 Jun 2026 10:30:00 +0200

Upgrade your skills from home! SymfonyOnline June 2026 brings 13 high-level technical sessions online on June 11-12, 2026.

🎤 Speaker announcement!

We are super happy to have Core Team member Robin Chalas with his talk "Symfony 8: The Hexagonal Track":

"Structuring an application around its domain rather than its framework is an old idea. Making it practical has sometimes felt like swimming against the current.

Thanks to the way Symfony 8 leverages modern PHP, this drastically changes. Recent evolutions in both the language and the framework align naturally with hexagonal thinking and tactical DDD patterns — no workarounds, no fighting the tools.

Join me as I wear both my Core Team member and DDD practitioner hats to give a pragmatic look at putting your business logic first, building applications that scale with your domain's complexity and remain maintainable as they grow, with Symfony's blessing."

👉 Discover more talks by reading the full schedule

✨ Key Feature: All talks are pre-recorded to ensure the highest technical quality, but speakers will be joining us live to answer your questions in real-time during the dedicated Q&A sessions!

🛠️ Pre-conference Workshops (June 9-10)

Note: Workshop spots are limited and no replays are available for these sessions to ensure an interactive learning experience.

🎟️ Register now!

Join the global PHP & Symfony community from the comfort of your home or office by clicking here.

▶️ Instant Replays: Missed a session? All talks are available for replay as soon as they start.
🆒 Accessibility: English subtitles are provided for all presentations.

We look forward to seeing you online to explore the future of PHP together!

Join us online!

💡Follow the "conference" blog posts to not miss anything!

Want the latest Symfony updates? Follow us and tune in from wherever you are 🌎

Sponsor the Symfony project.

New in Symfony 8.1: HttpClient Improvements

Javier Eguiluz — Wed, 03 Jun 2026 17:32:00 +0200

Symfony 8.1 ships a batch of improvements for the HttpClient component that touch performance, interoperability, security and testing.

Persistent cURL Connections

Contributed by Kostiantyn Miakshyn in #62751

When you make many requests in a row, re-establishing connections for every request adds DNS, TCP and TLS overhead. PHP 8.5 introduces persistent cURL handles and Symfony 8.1 exposes them through the new extra.use_persistent_connections option of CurlHttpClient:

        
        use Symfony\Component\HttpClient\CurlHttpClient;

$client = new CurlHttpClient([
    'extra' => [
        'use_persistent_connections' => true,
    ],
]);
    

When enabled (and running on PHP 8.5 or later), the DNS cache, SSL sessions and connection data are reused across requests, reducing the connection overhead. This is most useful for CLI commands and workers that make many sequential requests.

Using Symfony HttpClient as a Guzzle Handler

Contributed by Nicolas Grekas in #63433

Some SDKs are built on top of Guzzle and don't allow replacing the underlying HTTP client. Symfony 8.1 adds a GuzzleHttpHandler that lets those SDKs use Symfony HttpClient as their transport layer, benefiting from features such as retries, HTTP/2 support and scoped clients:

        
        use GuzzleHttp\Client;
use Symfony\Component\HttpClient\GuzzleHttpHandler;

$guzzle = new Client(['handler' => new GuzzleHttpHandler()]);

$response = $guzzle->request('GET', 'https://symfony.com/versions.json');

By default, the handler creates a new HttpClient instance. You can also pass any HttpClientInterface implementation to reuse the same configuration across your application and third-party SDKs.

Allowing Specific Hosts in NoPrivateNetworkHttpClient

Contributed by Pascal CESCON in #64160

NoPrivateNetworkHttpClient helps protect applications from SSRF attacks by blocking requests to private networks (10.0.0.0/8, 192.168.0.0/16, etc.). Symfony 8.1 adds a third $allowList argument that lets you exempt specific hosts (e.g. a local proxy) while continuing to block all other private-network addresses:

        
        use Symfony\Component\HttpClient\HttpClient;
use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;

$client = new NoPrivateNetworkHttpClient(
    HttpClient::create(),
    null,           // null = block the default private subnets
    '10.0.0.42',    // allow this host (also accepts an array of IPs/CIDR subnets)
);
    

Safer Default for Cached Responses

Contributed by Jérôme Parmentier and Nicolas Grekas in #63441

CachingHttpClient stores responses according to the cache-control directives returned by the server. When no cache directives are provided, responses could previously remain cached indefinitely.

In Symfony 8.1, the maximum time-to-live now defaults to 86400 seconds (24 hours) instead of being unlimited. Server-provided TTLs are still respected, but they are capped to this value to prevent stale cache entries from living indefinitely. You can change the cap with the max_ttl option:

        
        # config/packages/framework.yaml
framework:
    http_client:
        scoped_clients:
            example.client:
                base_uri: 'https://example.com'
                caching:
                    max_ttl: 3600
    

Passing null to disable the cap is now deprecated; you can only set positive integers as the value of this option.

Failing Fast with `max_connect_duration`

Contributed by Alexandre Daubois in #62854

The timeout option controls how long the client waits for activity on an idle connection and max_duration caps the total request time. Neither provides a strict deadline for establishing the connection.

Symfony 8.1 adds the max_connect_duration option, which limits the time spent on DNS resolution, the TCP connection and the TLS handshake:

        
        $response = $client->request('GET', 'https://...', [
    // fail fast if the connection cannot be established within 0.5 seconds
    'max_connect_duration' => 0.5,
    'timeout' => 10,
]);
    

A value of 0 or less means there is no limit on connection time, as long as the timeout option is respected.

Per-Client Mocking in Tests

Contributed by Tarjei Huse in #52265

When testing, you can set mock_response_factory to replace HttpClient with a mock that returns canned responses. In Symfony 8.1, this option can now be configured per scoped client, making it easier to mock specific APIs while leaving others untouched.

Set it to true for a MockHttpClient that returns empty 200 responses, to false to disable mocking for a specific client, or to a service ID for full control over the returned responses:

        
        # config/packages/test/framework.yaml
framework:
    http_client:
        mock_response_factory: true
        scoped_clients:
            my_api.client:
                base_uri: 'https://my-api.com'
                mock_response_factory: App\Tests\MyApiMockClientCallback
            not_mocked.client:
                base_uri: 'https://example.com'
                mock_response_factory: false
    

Custom DNS Resolution

Contributed by Peter Potrowl in #63770

Symfony 8.1 adds a DnsResolvingHttpClient decorator that lets you provide custom DNS resolution logic (e.g. to route requests to a specific server while debugging). The resolver receives the hostname and returns the IP address to use, or null to fall back to the default transport resolution:

        
        use Symfony\Component\HttpClient\DnsResolvingHttpClient;
use Symfony\Component\HttpClient\HttpClient;

$resolver = function (string $hostname): ?string {
    // implement your own resolution logic (service discovery, caching, etc.)
    return $ip; // or null to use the default DNS resolution
};

$client = new DnsResolvingHttpClient(HttpClient::create(), $resolver);
    

Sponsor the Symfony project.

SymfonyOnline June 2026: Building TUIs in PHP: The Symfony Terminal Component

Eloïse Charrier — Wed, 03 Jun 2026 16:30:00 +0200

SymfonyOnline June 2026 is taking place online next week, from June 11 to 12, 2026! Prepare for two days of pure Symfony and PHP innovation from the comfort of your screen.

🎤 Speaker announcement!

We are honored to feature Fabien Potencier with his talk "Building TUIs in PHP: The Symfony Terminal Component":

"With coding agents moving from the IDE to the terminal, TUIs are having a renaissance. This session introduces the new Symfony Terminal Component, a TUI toolkit built from the ground up in PHP. We'll explore its architecture, the primitives it exposes, and how it makes building rich, interactive terminal interfaces possible in Symfony applications."

👉 Discover more talks by reading the full schedule

✨ Key Feature: All talks are pre-recorded to ensure the highest technical quality, but speakers will be joining us live to answer your questions in real-time during the dedicated Q&A sessions!

🛠️ Pre-conference Workshops (June 9-10)

Note: Workshop spots are limited and no replays are available for these sessions to ensure an interactive learning experience.

🎟️ Register now!

Join the global PHP & Symfony community from the comfort of your home or office by clicking here.

▶️ Instant Replays: Missed a session? All talks are available for replay as soon as they start.
🆒 Accessibility: English subtitles are provided for all presentations.

We look forward to seeing you online to explore the future of PHP together!

Join us online!

💡Follow the "conference" blog posts to not miss anything!

Want the latest Symfony updates? Follow us and tune in from wherever you are 🌎

Sponsor the Symfony project.

Symfony Blog

New in Symfony 8.1: DX Improvements (Part 1)

SymfonyOnline June 2026: Reconfiguring Symfony​ in real time​ with sidekicks

🎤 Speaker announcement!

🎟️ Register now!

Join us online!

SymfonyOnline June 2026: Coding at the speed of thought: Symfony DX in 2026

🎤 Speaker announcement!

🛠️ Pre-conference Workshops (June 9-10)

🎟️ Register now!

Join us online!

SymfonyOnline June 2026: Dealing with audit logs

🎤 Speaker announcement!

🛠️ Pre-conference Workshops (June 9-10)

🎟️ Register now!

Join us online!

A Week of Symfony #1014 (June 1–7, 2026)

Symfony development highlights

Newest issues and pull requests

Symfony Jobs

They talked about us

Upcoming Symfony Events

Call to Action

New in Symfony 8.1: Console Progress and Testing Improvements

New in Symfony 8.1: ObjectMapper Improvements

SymfonyOnline June 2026: Symfony 8: The Hexagonal Track

🎤 Speaker announcement!

🛠️ Pre-conference Workshops (June 9-10)

🎟️ Register now!

Join us online!

New in Symfony 8.1: HttpClient Improvements

SymfonyOnline June 2026: Building TUIs in PHP: The Symfony Terminal Component

🎤 Speaker announcement!

🛠️ Pre-conference Workshops (June 9-10)

🎟️ Register now!

Join us online!

SymfonyOnline June 2026: Reconfiguring Symfony in real time with sidekicks