New in Symfony 6.1: Improved Routing Requirements and UTF-8 Parameters

Using PHP BackedEnum as Route Requirements

        Contributed by Thomas Calvet
         in #45803.

In PHP, backed enumerations are enumerations where all its elements are backed by some scalar value. This makes them useful to restrict the possible values of some routing parameter. In previous Symfony versions, you had to create the requirements manually using public constants:

    #[Route('/foo/{bar}', requirements: ['bar' => SomeEnum::AAA.'|'.SomeEnum::BBB])]

In Symfony 6.1, we're improving the Routing component to fully support \BackedEnum objects as follows:

    use Symfony\Component\Routing\Requirement\EnumRequirement;

// 'bar' parameter allows all values defined in the Enum

[Route('/foo/{bar}', requirements: ['bar' => new EnumRequirement(SomeEnum::class)])]

// 'bar' parameter only allows certain values of those defined in the Enum

[Route('/foo/{bar}', requirements: ['bar' => new EnumRequirement(SomeEnum::class, SomeEnum::Aaa, SomeEnum::Bbb)])]

A Collection of Common Routing Requirements

        Contributed by Thomas Calvet
         in #45528.

When defining routes, there are some requirements that repeat on many projects. For example, restricting some value to be an integer, or a date or a valid UUID pattern. In Symfony 6.1 we're introducing a Requirement enumeration to define all those common routing requirements so you can use them in your projects:

    use Symfony\Component\Routing\Requirement\Requirement;

[Route('/users/{id}', requirements: ['id' => Requirement::UUID_V4])]

[Route('/users/{id}')]

[Route('/posts/{date}/{slug}', requirements: [

'date' => Requirement::DATE_YMD,
'slug' => Requirement::ASCII_SLUG,

])]

// 'CATCH_ALL' is equivalent to '.+' (accepts all characters, including '/')

[Route('/category/{name}', requirements: ['name' => Requirement::CATCH_ALL])]

UTF-8 Parameter Names

        Contributed by Nicolas Grekas
         in #45054.

In PHP, variable identifiers can contain UTF-8 characters (e.g. $iñtërnâtiónàlizætiøn = '...') However, parameters in Symfony routes could only include ASCII characters. In Symfony 6.1 we're improving the Routing component to allow using UTF-8 characters in all route parameters:

    use Symfony\Component\Routing\Annotation\Route;

[Route('/blog/{föo}/{bár}', name: '...')]

public function someControllerMethod(string $föo, string $bár) { // ... }

                Sponsor the Symfony project.

https://symfony.com/blog/new-in-symfony-6-1-improved-routing-requirements-and-utf-8-parameters?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Creată 3y | 25 apr. 2022, 14:20:27


Autentifică-te pentru a adăuga comentarii

Alte posturi din acest grup

SymfonyCon Amsterdam 2025: Community Evening - Let’s Celebrate 20 Years of Symfony Together!

Symfony is turning 20 and we’re throwing a party you won’t want to miss! 🥳

Join us for an unforgettable evening of drinks, music, and great company at the Kanarie Club in Amsterdam!

This year

23 iul. 2025, 15:10:02 | Symfony
A Week of Symfony #968 (July 14–20, 2025)

This week, the upcoming Symfony 7.4 version improved the Serializer component by adding more prefix support to the accessor, added more code to make the JsonPath component RFC compliant, and added sup

20 iul. 2025, 08:20:04 | Symfony
A Week of Symfony #967 (July 7–13, 2025)

This week, Symfony unveiled the Symfony AI initiative, a set of components and bundles designed to bring powerful AI capabilities directly into your PHP applications. In addition, we published travel

13 iul. 2025, 09:20:11 | Symfony
Kicking off the Symfony AI Initiative

Today we are happy to announce a new Symfony initiative called Symfony AI - with the goal to provide a comprehensive set of components and bundles designed to bring powerful AI capabilities directly i

11 iul. 2025, 13:20:27 | Symfony
SymfonyCon Amsterdam 2025: Travel & Lodging Tips

SymfonyCon Amsterdam 2025, our next annual international Symfony conference, will take place on:

November 25 & 26: 2 workshops days with several topics to learn, practice and improve your skills

11 iul. 2025, 08:40:20 | Symfony
A Week of Symfony #966 (June 30 – July 6, 2025)

This week, development on the upcoming Symfony 8.0 version continued with the removal of deprecated features and the marking of several classes as final. In addition, we published two new case studies

6 iul. 2025, 08:10:15 | Symfony
Case study: Modernizing Audi France’s Digital Ecosystem with Symfony 6

At Wide, Micropole’s digital agency, they help leading brands modernize their digital infrastructures while ensuring scalability, security, and performance. When Audi France approached them to migrate

4 iul. 2025, 09:40:14 | Symfony