UPGRADE-2.3.md

UPGRADE FROM 2.2 to 2.3

EventDispatcher

• The getDispatcher() and getName() methods from Symfony\Component\EventDispatcher\Event are deprecated, the event dispatcher instance and event name can be received in the listener call instead.

  Before:

  use Symfony\Component\EventDispatcher\Event;
  
  class Foo
  {
      public function myFooListener(Event $event)
      {
          $dispatcher = $event->getDispatcher();
          $eventName = $event->getName();
          $dispatcher->dispatch('log', $event);
  
          // ... more code
     }
  }

  After:

  use Symfony\Component\EventDispatcher\Event;
  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
  
  class MyListenerClass
  {
      public function myListenerMethod(Event $event, $eventName, EventDispatcherInterface $dispatcher)
      {
          $dispatcher->dispatch('log', $event);
  
          // ... more code
      }
  }

  While this above is sufficient for most uses, if your module must be compatible with versions less than 2.3, or if your module uses multiple EventDispatcher instances, you might need to specifically inject a known instance of the EventDispatcher into your listeners. This could be done using constructor or setter injection as follows:

  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
  
  class MyListenerClass
  {
      protected $dispatcher = null;
  
      public function __construct(EventDispatcherInterface $dispatcher)
      {
          $this->dispatcher = $dispatcher;
      }
  }

Request and RequestStack

• The Request service are deprecated, you must now use the RequestStack service.

  In your loops

  The way to recover the request does not change.

  To get the current request

  class MyLoopClass extends BaseLoop implements PropelSearchLoopInterface
  {
      public function buildModelCriteria()
      {
          // Get the current request
          $request = $this->getCurrentRequest();
          // Or
          $request = $this->requestStack->getCurrentRequest();
  
          // ... more code
      }
  }

  In your controllers

  It's not recommended to use getRequest() and getSession(), the Request instance can be received in the action method parameters. However, the getRequest() method returns the current request. Warning !! This is not compatible with Thelia 2.0, because it uses Symfony 2.2

  To get the current request

  use Thelia\Core\HttpFoundation\Request;
  
  class MyControllerClass extends ...
  {
      public function MyActionMethod(Request $request, $query_parameters ...)
      {
          $session = $request->getSession();
          // ... more code
      }
  }

Container Scopes

• The "container scopes" concept no longer exists in Thelia 2.3. For backward compatibility, the attributes scope is automatically removed of the xml configuration files.
  Warning !! The attributes scope are always needed for your modules compatible with Thelia < 2.3.
  See the Symfony documentation for more information

Unit Test

• The SecurityContext, ParserContext, TokenProvider, TheliaFormFactory, TaxEngine services are no longer dependent on "Request", but "RequestSTack".
  This may break your unit tests.

For more information about the upgrade from Symfony 2.3 to Symfony 2.8

Upgrade from Symfony 2.3 to 2.4
Upgrade from Symfony 2.4 to 2.5
Upgrade from Symfony 2.5 to 2.6
Upgrade from Symfony 2.6 to 2.7
Upgrade from Symfony 2.7 to 2.8
Upgrade from Symfony 2.8 to 3.0