UPGRADE-6.0.md

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_TRAEFIKconstants 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

• 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

• 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:

  use Symfony\Component\Validator\Constraints as Assert;
  
  /**
   * @Assert\Length(min=5, allowEmptyString=true)
   */

  After:

  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:

$builder->enableAnnotationMapping($reader);

After:

$builder->enableAnnotationMapping(true)
    ->setDoctrineAnnotationReader($reader);

• ValidatorBuilder::enableAnnotationMapping() won't automatically setup a Doctrine annotation reader anymore.

Before:

$builder->enableAnnotationMapping();

After:

$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::parse('072');

  After:

  Yaml::parse('0o72');

• Removed support for using the !php/object and !php/const tags without a value.