Skip to content

Latest commit

 

History

History
164 lines (125 loc) · 5.88 KB

UPGRADE-4.1.md

File metadata and controls

164 lines (125 loc) · 5.88 KB

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.