Skip to content

[FrameworkBundle][Routing] Update the enabled_locales description #19777

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 23, 2024

Conversation

Comment on lines -431 to -433
If some user makes requests with a locale not included in this option, the
application won't display any error because Symfony will display contents using
the fallback locale.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there is no special locale parameter in request, this case is applied right ?

I think we should document it. I'm not sure what IS "fallback local", is it the default locale ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand your comment ... according to the code, if you use enabled_locales, the _locale will be set unconditionally:

https://github.com/symfony/symfony/blob/184597db05288c68c9eb11dff55239768268f646/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/FrameworkExtension.php#L1083-L1086

added as a requirement of the :ref:`special _locale parameter <routing-locale-parameter>`.
For example, if you define this value as ``['ar', 'he', 'ja', 'zh']``, the
``_locale`` routing parameter will have an ``ar|he|ja|zh`` requirement. If some
user makes requests with a locale not included in this option, they'll see an error.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we document what « error » ? 404 ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, it's a 404 error. I added that while merging. Thanks!

@carsonbot carsonbot changed the title [FrameworkBundle] Update the enabled_locales description [FrameworkBundle][Routing] Update the enabled_locales description Apr 19, 2024
@OskarStark OskarStark changed the title [FrameworkBundle][Routing] Update the enabled_locales description [FrameworkBundle][Routing] Update the enabled_locales description Apr 22, 2024
@javiereguiluz javiereguiluz merged commit ad0253c into symfony:5.4 Apr 23, 2024
3 checks passed
@javiereguiluz javiereguiluz deleted the route_enabled_locales branch April 23, 2024 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants