UPGRADE-4.1.md

UPGRADE FROM 4.0 to 4.1

Config

• Implementing ParentNodeDefinitionInterface without the getChildNodeDefinitions() method is deprecated.

Console

• Deprecated the setCrossingChar() method in favor of the setDefaultCrossingChar() method in TableStyle.
• The Processor class has been made final
• Deprecated the setHorizontalBorderChar() method in favor of the setDefaultCrossingChars() method in TableStyle.
• Deprecated the getHorizontalBorderChar() method in favor of the getBorderChars() method in TableStyle.
• Deprecated the setVerticalBorderChar() method in favor of the setVerticalBorderChars() method in TableStyle.
• Deprecated the getVerticalBorderChar() method in favor of the getBorderChars() method in TableStyle.
• Added support for iterable messages in write and writeln methods of Symfony\Component\Console\Output\OutputInterface. If you have a custom implementation of the interface, you should make sure it works with iterable as well.

DependencyInjection

• Deprecated the TypedReference::canBeAutoregistered() and TypedReference::getRequiringClass() methods.
• Deprecated support for auto-discovered extension configuration class which does not implement ConfigurationInterface.

EventDispatcher

• The TraceableEventDispatcherInterface has been deprecated.

Form

• Deprecated the ChoiceLoaderInterface implementation in CountryType, LanguageType, LocaleType and CurrencyType, use the choice_loader option instead.

  Before:

  class MyCountryType extends CountryType
  {
      public function loadChoiceList()
      {
          // override the method
      }
  }

  After:

  class MyCountryType extends AbstractType
  {
      public function getParent()
      {
          return CountryType::class;
      }
  
      public function configureOptions(OptionsResolver $resolver)
      {
          $resolver->setDefault('choice_loader', ...); // override the option instead
      }
  }

• Added help option to the form field. If you have custom Form extension for it, you should remove it. Also remove it from the custom form theme.

FrameworkBundle

• Deprecated bundle:controller:action and service:action syntaxes to reference controllers. Use serviceOrFqcn::method instead where serviceOrFqcn is either the service ID when using controllers as services or the FQCN of the controller.

  Before:

  bundle_controller:
      path: /
      defaults:
          _controller: FrameworkBundle:Redirect:redirect
  
  service_controller:
      path: /
      defaults:
          _controller: app.my_controller:myAction

  After:

  bundle_controller:
      path: /
      defaults:
          _controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction
  
  service_controller:
      path: /
      defaults:
          _controller: app.my_controller::myAction

• Deprecated Symfony\Bundle\FrameworkBundle\Controller\ControllerNameParser

• Warming up a router in RouterCacheWarmer that does not implement the WarmableInterface is deprecated and will not be supported anymore in 5.0.

• 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.
• Deprecated Symfony\Component\HttpFoundation\Request::getSession() when no session has been set. Use Symfony\Component\HttpFoundation\Request::hasSession() 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.
• AuthenticationUtils::getLastUsername() now always returns a string.
• The ExpressionVoter::addExpressionLanguageProvider() method is deprecated. Register the provider directly on the injected ExpressionLanguage instance instead.

SecurityBundle

• The logout_on_user_change firewall option is deprecated.
• The switch_user.stateless firewall option is deprecated, use the stateless option instead.
• The SecurityUserValueResolver class is deprecated, use Symfony\Component\Security\Http\Controller\UserValueResolver instead.

Serializer

• Decoding XML with XmlEncoder now ignores comment node types by default.

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 DefinitionBuilder::reset() method, use the clear() one instead.
• 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.
• Deprecated passing the workflow name as 4th parameter of Event constructor in favor of the workflow itself.