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

A Week of Symfony #962 (June 2–8, 2025)

This week, development activity focused on the upcoming Symfony 7.4 and 8.0 versions, which will deprecate and remove many features. In addition, we published a case study about Yousign. Finally, we'r

8 iun. 2025, 07:50:05 | Symfony
Case study - Yousign: Scaling Trust with Smart, Scalable Architecture

As digital signatures become the norm in modern business, Yousign has established itself as a trusted leader across Europe. Behind its simple, intuitive interface is a powerful technical engine, handl

6 iun. 2025, 07:10:24 | Symfony
SymfonyOnline June 2025 starts next week!

Get ready for the exciting SymfonyOnline June 2025, kicking off in a few days only! There’s still time to register and join the international online Symfony conference—along with pre-conferenc

5 iun. 2025, 10:20:09 | Symfony
A Week of Symfony #961 (May 26 – June 1, 2025)

This week, Symfony released the stable version of Symfony 7.3, which includes lots of amazing new features. We also published the maintenance versions 6.4.22 and 7.2.7.

Symfony development highlights

1 iun. 2025, 08:50:16 | Symfony
New in Symfony 7.3: DX Improvements (part 2)

This is the second part of the blog post showcasing the main DX (developer experience) features introduced in Symfony 7.3. Read the first part of this blog post.

Verify URI Signatures… https://symfon

29 mai 2025, 09:10:19 | Symfony
Symfony 6.4.22 released

Symfony 6.4.22 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in you

29 mai 2025, 09:10:19 | Symfony
Symfony 7.2.7 released

Symfony 7.2.7 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

29 mai 2025, 09:10:18 | Symfony