From 38333ed6d4bd654e8f7fe0daeb0a85fa4ff6ecf1 Mon Sep 17 00:00:00 2001 From: Steven Renaux Date: Mon, 21 Aug 2023 13:22:12 +0200 Subject: [PATCH 1/9] Update framework config --- reference/configuration/framework.rst | 25 ++++++++++--------------- reference/constraints/Email.rst | 8 -------- 2 files changed, 10 insertions(+), 23 deletions(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index cfbef6f46aa..503f647df50 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -53,13 +53,11 @@ out all the application users. handle_all_throwables ~~~~~~~~~~~~~~~~~~~~~ -**type**: ``boolean`` **default**: ``false`` +**type**: ``boolean`` **default**: ``true`` -If set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions +Set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions thrown by the application and will turn them into HTTP responses. -Starting from Symfony 7.0, the default value of this option will be ``true``. - .. versionadded:: 6.2 The ``handle_all_throwables`` option was introduced in Symfony 6.2. @@ -1641,11 +1639,13 @@ To see a list of all available storages, run: handler_id .......... -**type**: ``string`` **default**: ``session.handler.native_file`` +**type**: ``string`` or ``null`` **default**: ``null`` The service id used for session storage. The default value ``'session.handler.native_file'`` -will let Symfony manage the sessions itself using files to store the session metadata. -Set it to ``null`` to use the native PHP session mechanism. +will let Symfony manage the sessions itself using files to store the session metadata when +`framework.session.save_path` is set or `null` + +The default value ``null`` is to use the native PHP session mechanism. You can also :ref:`store sessions in a database `. .. _name: @@ -1831,7 +1831,7 @@ This option is related to the `session.sid_bits_per_character PHP option`_. save_path ......... -**type**: ``string`` **default**: ``%kernel.cache_dir%/sessions`` +**type**: ``string`` or ``null`` **default**: ``%kernel.cache_dir%/sessions`` This determines the argument to be passed to the save handler. If you choose the default file handler, this is the path where the session files are created. @@ -2734,12 +2734,7 @@ constraint verifies the submitted string entropy is matching the minimum entropy email_validation_mode ..................... -**type**: ``string`` **default**: ``loose`` - -.. deprecated:: 6.2 - - The ``loose`` default value is deprecated since Symfony 6.2. Starting from - Symfony 7.0, the default value of this option will be ``html5``. +**type**: ``string`` **default**: ``html5`` Sets the default value for the :ref:`"mode" option of the Email validator `. @@ -2932,7 +2927,7 @@ php_errors log ... -**type**: ``boolean|int`` **default**: ``%kernel.debug%`` +**type**: ``boolean|int`` **default**: ``true`` Use the application logger instead of the PHP logger for logging PHP errors. When an integer value is used, it also sets the log level. Those integer diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst index 19b1579b88a..cc8ccb661b0 100644 --- a/reference/constraints/Email.rst +++ b/reference/constraints/Email.rst @@ -108,9 +108,6 @@ Parameter Description This option defines the pattern used to validate the email address. Valid values are: -* ``loose`` uses a simple regular expression (just checks that at least one ``@`` - character is present, etc.). This validation is too simple and it's recommended - to use one of the other modes instead; * ``html5`` uses the regular expression of the `HTML5 email input element`_, except it enforces a tld to be present. * ``html5-allow-no-tld`` uses exactly the same regular expression as the `HTML5 email input element`_, @@ -133,11 +130,6 @@ The default value used by this option is set in the :ref:`framework.validation.email_validation_mode ` configuration option. -.. deprecated:: 6.2 - - The ``loose`` value is deprecated since Symfony 6.2. Starting from - Symfony 7.0, the default value of this option will be ``html5``. - .. include:: /reference/constraints/_normalizer-option.rst.inc .. include:: /reference/constraints/_payload-option.rst.inc From f86eaa5ae30dd75b2acbff01e38b7f8f16f41aa5 Mon Sep 17 00:00:00 2001 From: Steven Renaux Date: Wed, 30 Aug 2023 11:29:20 +0200 Subject: [PATCH 2/9] Update handler_id description --- reference/configuration/framework.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 503f647df50..cb363226b3a 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -1641,11 +1641,11 @@ handler_id **type**: ``string`` or ``null`` **default**: ``null`` -The service id used for session storage. The default value ``'session.handler.native_file'`` -will let Symfony manage the sessions itself using files to store the session metadata when -`framework.session.save_path` is set or `null` +By default at `null` if `framework.session.save_path` is not set. +The session handler configured by php.ini is used, unless option +`framework.session.save_path` is used, in which case the default is to store sessions +using the native file session handler. -The default value ``null`` is to use the native PHP session mechanism. You can also :ref:`store sessions in a database `. .. _name: From 544857f61ba48ab9027229a9eceaf5a6f7ee25c6 Mon Sep 17 00:00:00 2001 From: Steven Renaux Date: Thu, 19 Oct 2023 15:11:16 +0200 Subject: [PATCH 3/9] Update configuration + revert deleted deprecated message --- reference/configuration/framework.rst | 4 ++-- reference/constraints/Email.rst | 8 ++++++++ 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index aa85a98e2b8..7f4fa6b9eda 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -55,7 +55,7 @@ handle_all_throwables **type**: ``boolean`` **default**: ``true`` -Set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions +When at ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions thrown by the application and will turn them into HTTP responses. .. versionadded:: 6.2 @@ -1901,7 +1901,7 @@ This option is related to the `session.sid_bits_per_character PHP option`_. save_path ......... -**type**: ``string`` or ``null`` **default**: ``%kernel.cache_dir%/sessions`` +**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/sessions`` This determines the argument to be passed to the save handler. If you choose the default file handler, this is the path where the session files are created. diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst index cc8ccb661b0..19b1579b88a 100644 --- a/reference/constraints/Email.rst +++ b/reference/constraints/Email.rst @@ -108,6 +108,9 @@ Parameter Description This option defines the pattern used to validate the email address. Valid values are: +* ``loose`` uses a simple regular expression (just checks that at least one ``@`` + character is present, etc.). This validation is too simple and it's recommended + to use one of the other modes instead; * ``html5`` uses the regular expression of the `HTML5 email input element`_, except it enforces a tld to be present. * ``html5-allow-no-tld`` uses exactly the same regular expression as the `HTML5 email input element`_, @@ -130,6 +133,11 @@ The default value used by this option is set in the :ref:`framework.validation.email_validation_mode ` configuration option. +.. deprecated:: 6.2 + + The ``loose`` value is deprecated since Symfony 6.2. Starting from + Symfony 7.0, the default value of this option will be ``html5``. + .. include:: /reference/constraints/_normalizer-option.rst.inc .. include:: /reference/constraints/_payload-option.rst.inc From 1e7a0b6285002500c674559d403799e162bf1f54 Mon Sep 17 00:00:00 2001 From: Steven Renaux Date: Thu, 19 Oct 2023 16:40:45 +0200 Subject: [PATCH 4/9] Typo --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index f58683414fb..40c14bd662f 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -1639,7 +1639,7 @@ To see a list of all available storages, run: handler_id .......... -**type**: ``string`` or ``null`` **default**: ``null`` +**type**: ``string`` | ``null`` **default**: ``null`` By default at `null` if `framework.session.save_path` is not set. The session handler configured by php.ini is used, unless option From 9319c75c174e6ac840e9d66b34d0864ae1a1d137 Mon Sep 17 00:00:00 2001 From: Steven Renaux <59167761+StevenRenaux@users.noreply.github.com> Date: Fri, 22 Dec 2023 19:37:29 +0100 Subject: [PATCH 5/9] Update reference/configuration/framework.rst Co-authored-by: Oskar Stark --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 40c14bd662f..c75d684ba9d 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -1643,7 +1643,7 @@ handler_id By default at `null` if `framework.session.save_path` is not set. The session handler configured by php.ini is used, unless option -`framework.session.save_path` is used, in which case the default is to store sessions +``framework.session.save_path`` is used, in which case the default is to store sessions using the native file session handler. It is possible to :ref:`store sessions in a database `, From d0a61654209f8cc976da3719ae359b57c1b13c35 Mon Sep 17 00:00:00 2001 From: Steven Renaux <59167761+StevenRenaux@users.noreply.github.com> Date: Fri, 22 Dec 2023 19:37:36 +0100 Subject: [PATCH 6/9] Update reference/configuration/framework.rst Co-authored-by: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com> --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index c75d684ba9d..2f7d1c0304c 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -3030,7 +3030,7 @@ php_errors log ... -**type**: ``boolean|int`` **default**: ``true`` +**type**: ``boolean`` | ``int`` **default**: ``true`` Use the application logger instead of the PHP logger for logging PHP errors. When an integer value is used, it also sets the log level. Those integer From f062c9e3f1f711ea23cb70b99d27655ec5f82118 Mon Sep 17 00:00:00 2001 From: Steven Renaux <59167761+StevenRenaux@users.noreply.github.com> Date: Fri, 22 Dec 2023 19:37:42 +0100 Subject: [PATCH 7/9] Update reference/configuration/framework.rst Co-authored-by: Oskar Stark --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 2f7d1c0304c..dff4ce45b9b 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -55,7 +55,7 @@ handle_all_throwables **type**: ``boolean`` **default**: ``true`` -When at ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions +When set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions thrown by the application and will turn them into HTTP responses. .. versionadded:: 6.2 From 7dde176ccd5fb4b11e8a90cbf49f1e163584667f Mon Sep 17 00:00:00 2001 From: Steven Renaux <59167761+StevenRenaux@users.noreply.github.com> Date: Fri, 22 Dec 2023 19:37:48 +0100 Subject: [PATCH 8/9] Update reference/configuration/framework.rst Co-authored-by: Oskar Stark --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index dff4ce45b9b..f4c796279e9 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -1641,7 +1641,7 @@ handler_id **type**: ``string`` | ``null`` **default**: ``null`` -By default at `null` if `framework.session.save_path` is not set. +By default at ``null`` if ``framework.session.save_path`` is not set. The session handler configured by php.ini is used, unless option ``framework.session.save_path`` is used, in which case the default is to store sessions using the native file session handler. From 5577a37c3719b8571a4718eaf86b756ea7ed850d Mon Sep 17 00:00:00 2001 From: Steven Renaux <59167761+StevenRenaux@users.noreply.github.com> Date: Sat, 23 Dec 2023 16:00:54 +0100 Subject: [PATCH 9/9] Update framework.rst --- reference/configuration/framework.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 5ae75418e8a..162065d4720 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -59,7 +59,7 @@ When set to ``true``, the Symfony kernel will catch all ``\Throwable`` exception thrown by the application and will turn them into HTTP responses. The ``handle_all_throwables`` option was introduced in Symfony 6.2. -Starting from Symfony 7.0, the default value of this option is ``true``. +Starting from Symfony 7.0, the default value is ``true``. .. _configuration-framework-http_cache: