symfony/UPGRADE-4.1.md

UPGRADE FROM 4.0 to 4.1
=======================

Config
------

 * Implementing `ParentNodeDefinitionInterface` without the `getChildNodeDefinitions()` method
   is deprecated.

EventDispatcher
---------------

 * The `TraceableEventDispatcherInterface` has been deprecated.

FrameworkBundle
---------------

 * A `RouterInterface` that does not implement the `WarmableInterface` is deprecated.
 * The `RequestDataCollector` class has been deprecated. Use the `Symfony\Component\HttpKernel\DataCollector\RequestDataCollector` class instead.

HttpFoundation
--------------

 * Passing the file size to the constructor of the `UploadedFile` class is deprecated.

 * The `getClientSize()` method of the `UploadedFile` class is deprecated. Use `getSize()` instead.

Security
--------

 * The `ContextListener::setLogoutOnUserChange()` method is deprecated.
 * Using the `AdvancedUserInterface` is now deprecated. To use the existing
   functionality, create a custom user-checker based on the
   `Symfony\Component\Security\Core\User\UserChecker`.

SecurityBundle
--------------

 * The `logout_on_user_change` firewall option is deprecated.
 * The `SecurityUserValueResolver` class is deprecated, use
   `Symfony\Component\Security\Http\Controller\UserValueResolver` instead.

Translation
-----------

 * The `FileDumper::setBackup()` method is deprecated.
 * The `TranslationWriter::disableBackup()` method is deprecated.

TwigBundle
----------

 * Deprecated relying on the default value (`false`) of the `twig.strict_variables` configuration option. You should use `%kernel.debug%` explicitly instead, which will be the new default in 5.0.

Validator
--------

 * The `Email::__construct()` 'strict' property is deprecated. Use 'mode'=>"strict" instead.
 * Calling `EmailValidator::__construct()` method with a boolean parameter is deprecated, use `EmailValidator("strict")` instead.
 * Deprecated the `checkDNS` and `dnsMessage` options of the `Url` constraint.

Workflow
--------

 * Deprecated the `add` method in favor of the `addWorkflow` method in `Workflow\Registry`.
 * Deprecated `SupportStrategyInterface` in favor of `WorkflowSupportStrategyInterface`.
 * Deprecated the class `ClassInstanceSupportStrategy` in favor of the class `InstanceOfSupportStrategy`.
trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00			`UPGRADE FROM 4.0 to 4.1`
			`=======================`

Add feature allowing change of Path Separator 2017-04-04 15:56:32 +01:00			`Config`
			`------`

			* Implementing `ParentNodeDefinitionInterface` without the `getChildNodeDefinitions()` method
made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			`is deprecated.`
Add feature allowing change of Path Separator 2017-04-04 15:56:32 +01:00
Display orphaned events in profiler 2017-10-01 21:31:12 +01:00			`EventDispatcher`
			`---------------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* The `TraceableEventDispatcherInterface` has been deprecated.
Display orphaned events in profiler 2017-10-01 21:31:12 +01:00
[FrameworkBundle] add a notice when passing a routerInterface with warmupInterface in RouterCacheWarmer 2017-11-10 08:09:11 +00:00			`FrameworkBundle`
			`---------------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* A `RouterInterface` that does not implement the `WarmableInterface` is deprecated.
			* The `RequestDataCollector` class has been deprecated. Use the `Symfony\Component\HttpKernel\DataCollector\RequestDataCollector` class instead.
[FrameworkBundle] add a notice when passing a routerInterface with warmupInterface in RouterCacheWarmer 2017-11-10 08:09:11 +00:00
sync upgrade and changelog files 2017-12-12 19:03:06 +00:00			`HttpFoundation`
			`--------------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* Passing the file size to the constructor of the `UploadedFile` class is deprecated.
sync upgrade and changelog files 2017-12-12 19:03:06 +00:00
			* The `getClientSize()` method of the `UploadedFile` class is deprecated. Use `getSize()` instead.

trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00			`Security`
			`--------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* The `ContextListener::setLogoutOnUserChange()` method is deprecated.
Deprecated the AdvancedUserInterface 2017-12-11 09:34:00 +00:00			* Using the `AdvancedUserInterface` is now deprecated. To use the existing
			`functionality, create a custom user-checker based on the`
made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			`Symfony\Component\Security\Core\User\UserChecker`.
trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00
			`SecurityBundle`
			`--------------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* The `logout_on_user_change` firewall option is deprecated.
			* The `SecurityUserValueResolver` class is deprecated, use
Move SecurityUserValueResolver to security-http 2017-12-20 14:22:44 +00:00			`Symfony\Component\Security\Http\Controller\UserValueResolver` instead.
trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00
			`Translation`
			`-----------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* The `FileDumper::setBackup()` method is deprecated.
			* The `TranslationWriter::disableBackup()` method is deprecated.
[Workflow] Introduce a Workflow interface 2017-10-30 06:24:47 +00:00
Deprecating "false" as default value of "strict_variable" under Twig configuration 2018-01-12 21:15:14 +00:00			`TwigBundle`
			`----------`

			* Deprecated relying on the default value (`false`) of the `twig.strict_variables` configuration option. You should use `%kernel.debug%` explicitly instead, which will be the new default in 5.0.

[Validator] Html5 Email Validation Currently we only support a very loose validation. There is now a standard HTML5 element with matching regex. This will add the ability to set a `mode` on the email validator. The mode will change the validation that is applied to the field as a whole. These modes are: * loose: The pattern from previous Symfony versions (default) * strict: Strictly matching the RFC * html5: The regex used for the HTML5 Element Deprecates the `strict=true` parameter in favour of `mode='strict'` 2017-10-05 16:50:07 +01:00			`Validator`
			`--------`

made deprecation notices less verbose 2018-02-19 11:42:56 +00:00			* The `Email::__construct()` 'strict' property is deprecated. Use 'mode'=>"strict" instead.
			* Calling `EmailValidator::__construct()` method with a boolean parameter is deprecated, use `EmailValidator("strict")` instead.
			* Deprecated the `checkDNS` and `dnsMessage` options of the `Url` constraint.
[Validator] Html5 Email Validation Currently we only support a very loose validation. There is now a standard HTML5 element with matching regex. This will add the ability to set a `mode` on the email validator. The mode will change the validation that is applied to the field as a whole. These modes are: * loose: The pattern from previous Symfony versions (default) * strict: Strictly matching the RFC * html5: The regex used for the HTML5 Element Deprecates the `strict=true` parameter in favour of `mode='strict'` 2017-10-05 16:50:07 +01:00
[Workflow] Introduce a Workflow interface 2017-10-30 06:24:47 +00:00			`Workflow`
			`--------`

			* Deprecated the `add` method in favor of the `addWorkflow` method in `Workflow\Registry`.
			* Deprecated `SupportStrategyInterface` in favor of `WorkflowSupportStrategyInterface`.
			* Deprecated the class `ClassInstanceSupportStrategy` in favor of the class `InstanceOfSupportStrategy`.