380 lines
16 KiB
Markdown
380 lines
16 KiB
Markdown
UPGRADE FROM 5.x to 6.0
|
|
=======================
|
|
|
|
Asset
|
|
-----
|
|
|
|
* Removed `RemoteJsonManifestVersionStrategy`, use `JsonManifestVersionStrategy` instead.
|
|
|
|
Config
|
|
------
|
|
|
|
* The signature of method `NodeDefinition::setDeprecated()` has been updated to `NodeDefinition::setDeprecation(string $package, string $version, string $message)`.
|
|
* The signature of method `BaseNode::setDeprecated()` has been updated to `BaseNode::setDeprecation(string $package, string $version, string $message)`.
|
|
* Passing a null message to `BaseNode::setDeprecated()` to un-deprecate a node is not supported anymore.
|
|
* Removed `BaseNode::getDeprecationMessage()`, use `BaseNode::getDeprecation()` instead.
|
|
|
|
Console
|
|
-------
|
|
|
|
* `Command::setHidden()` has a default value (`true`) for `$hidden` parameter
|
|
|
|
DependencyInjection
|
|
-------------------
|
|
|
|
* The signature of method `Definition::setDeprecated()` has been updated to `Definition::setDeprecation(string $package, string $version, string $message)`.
|
|
* The signature of method `Alias::setDeprecated()` has been updated to `Alias::setDeprecation(string $package, string $version, string $message)`.
|
|
* The signature of method `DeprecateTrait::deprecate()` has been updated to `DeprecateTrait::deprecation(string $package, string $version, string $message)`.
|
|
* Removed the `Psr\Container\ContainerInterface` and `Symfony\Component\DependencyInjection\ContainerInterface` aliases of the `service_container` service,
|
|
configure them explicitly instead.
|
|
* Removed `Definition::getDeprecationMessage()`, use `Definition::getDeprecation()` instead.
|
|
* Removed `Alias::getDeprecationMessage()`, use `Alias::getDeprecation()` instead.
|
|
* The `inline()` function from the PHP-DSL has been removed, use `inline_service()` instead.
|
|
* The `ref()` function from the PHP-DSL has been removed, use `service()` instead.
|
|
* Removed `Definition::setPrivate()` and `Alias::setPrivate()`, use `setPublic()` instead
|
|
|
|
DomCrawler
|
|
----------
|
|
|
|
* Removed the `parents()` method, use `ancestors()` instead.
|
|
|
|
Dotenv
|
|
------
|
|
|
|
* Removed argument `$usePutenv` from Dotenv's constructor, use `Dotenv::usePutenv()` instead.
|
|
|
|
EventDispatcher
|
|
---------------
|
|
|
|
* Removed `LegacyEventDispatcherProxy`. Use the event dispatcher without the proxy.
|
|
|
|
Form
|
|
----
|
|
|
|
* The default value of the `rounding_mode` option of the `PercentType` has been changed to `\NumberFormatter::ROUND_HALFUP`.
|
|
* The default rounding mode of the `PercentToLocalizedStringTransformer` has been changed to `\NumberFormatter::ROUND_HALFUP`.
|
|
* Added the `getIsEmptyCallback()` method to the `FormConfigInterface`.
|
|
* Added the `setIsEmptyCallback()` method to the `FormConfigBuilderInterface`.
|
|
* Added argument `callable|null $filter` to `ChoiceListFactoryInterface::createListFromChoices()` and `createListFromLoader()`.
|
|
* The `Symfony\Component\Form\Extension\Validator\Util\ServerParams` class has been removed, use its parent `Symfony\Component\Form\Util\ServerParams` instead.
|
|
* The `NumberToLocalizedStringTransformer::ROUND_*` constants have been removed, use `\NumberFormatter::ROUND_*` instead.
|
|
* Removed `PropertyPathMapper` in favor of `DataMapper` and `PropertyPathAccessor`.
|
|
* Changed `$forms` parameter type of the `DataMapper::mapDataToForms()` method from `iterable` to `\Traversable`.
|
|
* Changed `$forms` parameter type of the `DataMapper::mapFormsToData()` method from `iterable` to `\Traversable`.
|
|
* Changed `$checkboxes` parameter type of the `CheckboxListMapper::mapDataToForms()` method from `iterable` to `\Traversable`.
|
|
* Changed `$checkboxes` parameter type of the `CheckboxListMapper::mapFormsToData()` method from `iterable` to `\Traversable`.
|
|
* Changed `$radios` parameter type of the `RadioListMapper::mapDataToForms()` method from `iterable` to `\Traversable`.
|
|
* Changed `$radios` parameter type of the `RadioListMapper::mapFormsToData()` method from `iterable` to `\Traversable`.
|
|
|
|
FrameworkBundle
|
|
---------------
|
|
|
|
* Remove the `session.storage` alias and `session.storage.*` services, use the `session.storage.factory` alias and `session.storage.factory.*` services instead
|
|
* Remove `framework.session.storage_id` configuration option, use the `framework.session.storage_factory_id` configuration option instead
|
|
* Remove the `session` service and the `SessionInterface` alias, use the `\Symfony\Component\HttpFoundation\Request::getSession()` or the new `\Symfony\Component\HttpFoundation\RequestStack::getSession()` methods instead
|
|
* `MicroKernelTrait::configureRoutes()` is now always called with a `RoutingConfigurator`
|
|
* The "framework.router.utf8" configuration option defaults to `true`
|
|
* Removed `session.attribute_bag` service and `session.flash_bag` service.
|
|
* The `form.factory`, `form.type.file`, `translator`, `security.csrf.token_manager`, `serializer`,
|
|
`cache_clearer`, `filesystem` and `validator` services are now private.
|
|
* Removed the `lock.RESOURCE_NAME` and `lock.RESOURCE_NAME.store` services and the `lock`, `LockInterface`, `lock.store` and `PersistingStoreInterface` aliases, use `lock.RESOURCE_NAME.factory`, `lock.factory` or `LockFactory` instead.
|
|
|
|
HttpFoundation
|
|
--------------
|
|
|
|
* Remove the `NamespacedAttributeBag` class
|
|
* Removed `Response::create()`, `JsonResponse::create()`,
|
|
`RedirectResponse::create()`, `StreamedResponse::create()` and
|
|
`BinaryFileResponse::create()` methods (use `__construct()` instead)
|
|
* Not passing a `Closure` together with `FILTER_CALLBACK` to `ParameterBag::filter()` throws an `InvalidArgumentException`; wrap your filter in a closure instead.
|
|
* Removed the `Request::HEADER_X_FORWARDED_ALL` constant, use either `Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO` or `Request::HEADER_X_FORWARDED_AWS_ELB` or `Request::HEADER_X_FORWARDED_TRAEFIK`constants instead.
|
|
|
|
HttpKernel
|
|
----------
|
|
|
|
* Remove `ArgumentInterface`
|
|
* Remove `ArgumentMetadata::getAttribute()`, use `getAttributes()` instead
|
|
* Made `WarmableInterface::warmUp()` return a list of classes or files to preload on PHP 7.4+
|
|
* Removed support for `service:action` syntax to reference controllers. Use `serviceOrFqcn::method` instead.
|
|
|
|
Inflector
|
|
---------
|
|
|
|
* The component has been removed, use `EnglishInflector` from the String component instead.
|
|
|
|
Lock
|
|
----
|
|
|
|
* Removed the `NotSupportedException`. It shouldn't be thrown anymore.
|
|
* Removed the `RetryTillSaveStore`. Logic has been moved in `Lock` and is not needed anymore.
|
|
|
|
Mailer
|
|
------
|
|
|
|
* Removed the `SesApiTransport` class. Use `SesApiAsyncAwsTransport` instead.
|
|
* Removed the `SesHttpTransport` class. Use `SesHttpAsyncAwsTransport` instead.
|
|
|
|
Messenger
|
|
---------
|
|
|
|
* Removed AmqpExt transport. Run `composer require symfony/amqp-messenger` to keep the transport in your application.
|
|
* Removed Doctrine transport. Run `composer require symfony/doctrine-messenger` to keep the transport in your application.
|
|
* Removed RedisExt transport. Run `composer require symfony/redis-messenger` to keep the transport in your application.
|
|
* Use of invalid options in Redis and AMQP connections now throws an error.
|
|
* The signature of method `RetryStrategyInterface::isRetryable()` has been updated to `RetryStrategyInterface::isRetryable(Envelope $message, \Throwable $throwable = null)`.
|
|
* The signature of method `RetryStrategyInterface::getWaitingTime()` has been updated to `RetryStrategyInterface::getWaitingTime(Envelope $message, \Throwable $throwable = null)`.
|
|
* Removed the `prefetch_count` parameter in the AMQP bridge.
|
|
* Removed the use of TLS option for Redis Bridge, use `rediss://127.0.0.1` instead of `redis://127.0.0.1?tls=1`
|
|
|
|
Mime
|
|
----
|
|
|
|
* Removed `Address::fromString()`, use `Address::create()` instead
|
|
|
|
Monolog
|
|
-------
|
|
|
|
* The `$actionLevel` constructor argument of `Symfony\Bridge\Monolog\Handler\FingersCrossed\NotFoundActivationStrategy` has been replaced by the `$inner` one which expects an ActivationStrategyInterface to decorate instead. `Symfony\Bridge\Monolog\Handler\FingersCrossed\NotFoundActivationStrategy` is now final.
|
|
* The `$actionLevel` constructor argument of `Symfony\Bridge\Monolog\Handler\FingersCrossed\HttpCodeActivationStrategy` has been replaced by the `$inner` one which expects an ActivationStrategyInterface to decorate instead. `Symfony\Bridge\Monolog\Handler\FingersCrossed\HttpCodeActivationStrategy` is now final.
|
|
|
|
OptionsResolver
|
|
---------------
|
|
|
|
* The signature of method `OptionsResolver::setDeprecated()` has been updated to `OptionsResolver::setDeprecated(string $option, string $package, string $version, $message)`.
|
|
* Removed `OptionsResolverIntrospector::getDeprecationMessage()`, use `OptionsResolverIntrospector::getDeprecation()` instead.
|
|
|
|
PhpUnitBridge
|
|
-------------
|
|
|
|
* Removed support for `@expectedDeprecation` annotations, use the `ExpectDeprecationTrait::expectDeprecation()` method instead.
|
|
* Removed the `SetUpTearDownTrait` trait, use original methods with "void" return typehint.
|
|
|
|
PropertyAccess
|
|
--------------
|
|
|
|
* Drop support for booleans as the second argument of `PropertyAccessor::__construct()`, pass a combination of bitwise flags instead.
|
|
* Dropped support for booleans as the first argument of `PropertyAccessor::__construct()`.
|
|
Pass a combination of bitwise flags instead.
|
|
|
|
PropertyInfo
|
|
------------
|
|
|
|
* Removed the `Type::getCollectionKeyType()` and `Type::getCollectionValueType()` methods, use `Type::getCollectionKeyTypes()` and `Type::getCollectionValueTypes()` instead.
|
|
* Dropped the `enable_magic_call_extraction` context option in `ReflectionExtractor::getWriteInfo()` and `ReflectionExtractor::getReadInfo()` in favor of `enable_magic_methods_extraction`.
|
|
|
|
Routing
|
|
-------
|
|
|
|
* Removed `RouteCollectionBuilder`.
|
|
* Added argument `$priority` to `RouteCollection::add()`
|
|
* Removed the `RouteCompiler::REGEX_DELIMITER` constant
|
|
* Removed the `$data` parameter from the constructor of the `Route` annotation class
|
|
|
|
Security
|
|
--------
|
|
|
|
* Remove `UserInterface::getPassword()`
|
|
If your `getPassword()` method does not return `null` (i.e. you are using password-based authentication),
|
|
you should implement `PasswordAuthenticatedUserInterface`.
|
|
|
|
Before:
|
|
```php
|
|
use Symfony\Component\Security\Core\User\UserInterface;
|
|
|
|
class User implements UserInterface
|
|
{
|
|
// ...
|
|
|
|
public function getPassword()
|
|
{
|
|
return $this->password;
|
|
}
|
|
}
|
|
```
|
|
|
|
After:
|
|
```php
|
|
use Symfony\Component\Security\Core\User\UserInterface;
|
|
use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
|
|
|
|
class User implements UserInterface, PasswordAuthenticatedUserInterface
|
|
{
|
|
// ...
|
|
|
|
public function getPassword(): ?string
|
|
{
|
|
return $this->password;
|
|
}
|
|
}
|
|
```
|
|
|
|
* Remove `UserInterface::getSalt()`
|
|
If your `getSalt()` method does not return `null` (i.e. you are using password-based authentication with an old password hash algorithm that requires user-provided salts),
|
|
implement `LegacyPasswordAuthenticatedUserInterface`.
|
|
|
|
Before:
|
|
```php
|
|
use Symfony\Component\Security\Core\User\UserInterface;
|
|
|
|
class User implements UserInterface
|
|
{
|
|
// ...
|
|
|
|
public function getPassword()
|
|
{
|
|
return $this->password;
|
|
}
|
|
|
|
public function getSalt()
|
|
{
|
|
return $this->salt;
|
|
}
|
|
}
|
|
```
|
|
|
|
After:
|
|
```php
|
|
use Symfony\Component\Security\Core\User\UserInterface;
|
|
use Symfony\Component\Security\Core\User\LegacyPasswordAuthenticatedUserInterface;
|
|
|
|
class User implements UserInterface, LegacyPasswordAuthenticatedUserInterface
|
|
{
|
|
// ...
|
|
|
|
public function getPassword(): ?string
|
|
{
|
|
return $this->password;
|
|
}
|
|
|
|
public function getSalt(): ?string
|
|
{
|
|
return $this->salt;
|
|
}
|
|
}
|
|
```
|
|
|
|
* Calling `PasswordUpgraderInterface::upgradePassword()` with a `UserInterface` instance that
|
|
does not implement `PasswordAuthenticatedUserInterface` now throws a `\TypeError`.
|
|
* Calling methods `hashPassword()`, `isPasswordValid()` and `needsRehash()` on `UserPasswordHasherInterface`
|
|
with a `UserInterface` instance that does not implement `PasswordAuthenticatedUserInterface` now throws a `\TypeError`
|
|
* Drop all classes in the `Core\Encoder\` sub-namespace, use the `PasswordHasher` component instead
|
|
* Drop support for `SessionInterface $session` as constructor argument of `SessionTokenStorage`, inject a `\Symfony\Component\HttpFoundation\RequestStack $requestStack` instead
|
|
* Drop support for `session` provided by the ServiceLocator injected in `UsageTrackingTokenStorage`, provide a `request_stack` service instead
|
|
* Make `SessionTokenStorage` throw a `SessionNotFoundException` when called outside a request context
|
|
* Removed `ROLE_PREVIOUS_ADMIN` role in favor of `IS_IMPERSONATOR` attribute
|
|
* Removed `LogoutSuccessHandlerInterface` and `LogoutHandlerInterface`, register a listener on the `LogoutEvent` event instead.
|
|
* Removed `DefaultLogoutSuccessHandler` in favor of `DefaultLogoutListener`.
|
|
* Added a `logout(Request $request, Response $response, TokenInterface $token)` method to the `RememberMeServicesInterface`.
|
|
* Removed `setProviderKey()`/`getProviderKey()` in favor of `setFirewallName()/getFirewallName()`
|
|
in `PreAuthenticatedToken`, `RememberMeToken`, `SwitchUserToken`, `UsernamePasswordToken`,
|
|
`DefaultAuthenticationSuccessHandler`.
|
|
* Removed the `AbstractRememberMeServices::$providerKey` property in favor of `AbstractRememberMeServices::$firewallName`
|
|
* `AccessDecisionManager` now throw an exception when a voter does not return a valid decision.
|
|
|
|
SecurityBundle
|
|
--------------
|
|
|
|
* Remove the `UserPasswordEncoderCommand` class and the corresponding `user:encode-password` command,
|
|
use `UserPasswordHashCommand` and `user:hash-password` instead
|
|
* Remove the `security.encoder_factory.generic` service, the `security.encoder_factory` and `Symfony\Component\Security\Core\Encoder\EncoderFactoryInterface` aliases,
|
|
use `security.password_hasher_factory` and `Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactoryInterface` instead
|
|
* Remove the `security.user_password_encoder.generic` service, the `security.password_encoder` and the `Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface` aliases,
|
|
use `security.user_password_hasher`, `security.password_hasher` and `Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface` instead
|
|
|
|
Serializer
|
|
----------
|
|
|
|
* Removed `ArrayDenormalizer::setSerializer()`, call `setDenormalizer()` instead.
|
|
* `ArrayDenormalizer` does not implement `SerializerAwareInterface` anymore.
|
|
|
|
TwigBundle
|
|
----------
|
|
|
|
* The `twig` service is now private.
|
|
|
|
Validator
|
|
---------
|
|
|
|
* Removed the `allowEmptyString` option from the `Length` constraint.
|
|
|
|
Before:
|
|
|
|
```php
|
|
use Symfony\Component\Validator\Constraints as Assert;
|
|
|
|
/**
|
|
* @Assert\Length(min=5, allowEmptyString=true)
|
|
*/
|
|
```
|
|
|
|
After:
|
|
|
|
```php
|
|
use Symfony\Component\Validator\Constraints as Assert;
|
|
|
|
/**
|
|
* @Assert\AtLeastOneOf({
|
|
* @Assert\Blank(),
|
|
* @Assert\Length(min=5)
|
|
* })
|
|
*/
|
|
```
|
|
|
|
* Removed the `NumberConstraintTrait` trait.
|
|
|
|
* `ValidatorBuilder::enableAnnotationMapping()` does not accept a Doctrine annotation reader anymore.
|
|
|
|
Before:
|
|
|
|
```php
|
|
$builder->enableAnnotationMapping($reader);
|
|
```
|
|
|
|
After:
|
|
|
|
```php
|
|
$builder->enableAnnotationMapping(true)
|
|
->setDoctrineAnnotationReader($reader);
|
|
```
|
|
|
|
* `ValidatorBuilder::enableAnnotationMapping()` won't automatically setup a Doctrine annotation reader anymore.
|
|
|
|
Before:
|
|
|
|
```php
|
|
$builder->enableAnnotationMapping();
|
|
```
|
|
|
|
After:
|
|
|
|
```php
|
|
$builder->enableAnnotationMapping(true)
|
|
->addDefaultDoctrineAnnotationReader();
|
|
```
|
|
|
|
Workflow
|
|
--------
|
|
|
|
* Remove `InvalidTokenConfigurationException`
|
|
|
|
Yaml
|
|
----
|
|
|
|
* Added support for parsing numbers prefixed with `0o` as octal numbers.
|
|
* Removed support for parsing numbers starting with `0` as octal numbers. They will be parsed as strings. Prefix numbers with `0o`
|
|
so that they are parsed as octal numbers.
|
|
|
|
Before:
|
|
|
|
```yaml
|
|
Yaml::parse('072');
|
|
```
|
|
|
|
After:
|
|
|
|
```yaml
|
|
Yaml::parse('0o72');
|
|
```
|
|
|
|
* Removed support for using the `!php/object` and `!php/const` tags without a value.
|