symfony/UPGRADE-4.1.md

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

Config
------

 * Implementing `ParentNodeDefinitionInterface` without the `getChildNodeDefinitions()` method
   is deprecated and will be unsupported in 5.0.

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

 * The `TraceableEventDispatcherInterface` has been deprecated and will be removed in 5.0.

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

 * A `RouterInterface` that does not implement the `WarmableInterface` is deprecated and will not be supported in Symfony 5.0.

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

 * Passing the file size to the constructor of the `UploadedFile` class is deprecated and won't be
   supported anymore in 5.0.

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

Security
--------

 * The `ContextListener::setLogoutOnUserChange()` method is deprecated and will be removed in 5.0.
 * 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`. This functionality will
   be removed in Symfony 5.0.

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

 * The `logout_on_user_change` firewall option is deprecated and will be removed in 5.0.
 * The `SecurityUserValueResolver` class is deprecated and will be removed in 5.0, use
   `Symfony\Component\Security\Http\Controller\UserValueResolver` instead.

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

 * The `FileDumper::setBackup()` method is deprecated and will be removed in 5.0.
 * The `TranslationWriter::disableBackup()` method is deprecated and will be removed in 5.0.

Validator
--------

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

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
			`is deprecated and will be unsupported in 5.0.`

Display orphaned events in profiler 2017-10-01 21:31:12 +01:00			`EventDispatcher`
			`---------------`

			* The `TraceableEventDispatcherInterface` has been deprecated and will be removed in 5.0.

[FrameworkBundle] add a notice when passing a routerInterface with warmupInterface in RouterCacheWarmer 2017-11-10 08:09:11 +00:00			`FrameworkBundle`
			`---------------`

			* A `RouterInterface` that does not implement the `WarmableInterface` is deprecated and will not be supported in Symfony 5.0.

sync upgrade and changelog files 2017-12-12 19:03:06 +00:00			`HttpFoundation`
			`--------------`

			* Passing the file size to the constructor of the `UploadedFile` class is deprecated and won't be
			`supported anymore in 5.0.`

			* 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`
			`--------`

			* The `ContextListener::setLogoutOnUserChange()` method is deprecated and will be removed in 5.0.
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`
			`Symfony\Component\Security\Core\User\UserChecker`. This functionality will
			`be removed in Symfony 5.0.`
trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00
			`SecurityBundle`
			`--------------`

			* The `logout_on_user_change` firewall option is deprecated and will be removed in 5.0.
Move SecurityUserValueResolver to security-http 2017-12-20 14:22:44 +00:00			* The `SecurityUserValueResolver` class is deprecated and will be removed in 5.0, use
			`Symfony\Component\Security\Http\Controller\UserValueResolver` instead.
trigger some deprecations for legacy methods 2017-11-23 10:49:18 +00:00
			`Translation`
			`-----------`

			* The `FileDumper::setBackup()` method is deprecated and will be removed in 5.0.
			* The `TranslationWriter::disableBackup()` method is deprecated and will be removed in 5.0.
[Workflow] Introduce a Workflow interface 2017-10-30 06:24:47 +00:00
[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`
			`--------`

			* The `Email::__construct()` 'strict' property is deprecated and will be removed in 5.0. Use 'mode'=>"strict" instead.
			* Calling `EmailValidator::__construct()` method with a boolean parameter is deprecated and will be removed in 5.0, use `EmailValidator("strict")` instead.
[Validator] Deprecated "checkDNS" option in Url constraint 2017-12-15 13:47:48 +00:00			* Deprecated the `checkDNS` and `dnsMessage` options of the `Url` constraint. They will be removed 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
[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`.