Skip to content

Commit 4c419a2

Browse files
committed
Merge branch '4.4' into 5.0
* 4.4: [#12636] Link to PHP.net's UTF-8 docs Fixed the explanation of the utf8 router option
2 parents d4419b2 + bae1123 commit 4c419a2

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

reference/configuration/framework.rst

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1158,7 +1158,11 @@ utf8
11581158

11591159
**type**: ``boolean`` **default**: ``false``
11601160

1161-
When this option is set to ``true``, route patterns can include UTF-8 characters.
1161+
When this option is set to ``true``, the regular expressions used in the
1162+
:ref:`requirements of route parameters <routing-requirements>` will be run
1163+
using the `utf-8 modifier`_. This will for example match any UTF-8 character
1164+
when using ``.``, instead of matching only a single byte.
1165+
11621166
If the charset of your application is UTF-8 (as defined in the
11631167
:ref:`getCharset() method <configuration-kernel-charset>` of your kernel) it's
11641168
recommended to set it to ``true``. This will make non-UTF8 URLs to generate 404
@@ -2902,3 +2906,4 @@ to know their differences.
29022906
.. _`haveibeenpwned.com`: https://haveibeenpwned.com/
29032907
.. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
29042908
.. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/desktop/secauthn/microsoft-ntlm
2909+
.. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers

0 commit comments

Comments
 (0)