Skip to content

Commit bae1123

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

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
@@ -1191,7 +1191,11 @@ utf8
11911191

11921192
**type**: ``boolean`` **default**: ``false``
11931193

1194-
When this option is set to ``true``, route patterns can include UTF-8 characters.
1194+
When this option is set to ``true``, the regular expressions used in the
1195+
:ref:`requirements of route parameters <routing-requirements>` will be run
1196+
using the `utf-8 modifier`_. This will for example match any UTF-8 character
1197+
when using ``.``, instead of matching only a single byte.
1198+
11951199
If the charset of your application is UTF-8 (as defined in the
11961200
:ref:`getCharset() method <configuration-kernel-charset>` of your kernel) it's
11971201
recommended to set it to ``true``. This will make non-UTF8 URLs to generate 404
@@ -3090,3 +3094,4 @@ to know their differences.
30903094
.. _`haveibeenpwned.com`: https://haveibeenpwned.com/
30913095
.. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
30923096
.. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/desktop/secauthn/microsoft-ntlm
3097+
.. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers

0 commit comments

Comments
 (0)