symfony/UPGRADE-2.1.md

UPGRADE FROM 2.0 to 2.1
=======================

* assets_base_urls and base_urls merging strategy has changed

  Unlike most configuration blocks, successive values for
  ``assets_base_urls`` will overwrite each other instead of being merged.
  This behavior was chosen because developers will typically define base
  URL's for each environment. Given that most projects tend to inherit
  configurations (e.g. ``config_test.yml`` imports ``config_dev.yml``)
  and/or share a common base configuration (i.e. ``config.yml``), merging
  could yield a set of base URL's for multiple environments.

* moved management of the locale from the Session class to the Request class

  Configuring the default locale:

  Before:

      framework:
        session:
            default_locale: fr

  After:

      framework:
        default_locale: fr

  Retrieving the locale from a Twig template:

  Before: {{ app.request.session.locale }} or {{ app.session.locale }}
  After: {{ app.request.locale }}

  Retrieving the locale from a PHP template:

  Before: $view['session']->getLocale()
  After: $view['request']->getLocale()

  Retrieving the locale from PHP code:

  Before: $session->getLocale()
  After: $request->getLocale()

* Method `equals` of `Symfony\Component\Security\Core\User\UserInterface` has
  moved to `Symfony\Component\Security\Core\User\EquatableInterface`.

  You have to change the name of the `equals` function in your implementation
  of the `User` class to `isEqualTo` and implement `EquatableInterface`.
  Apart from that, no other changes are required to make it behave as before.
  Alternatively, you can use the default implementation provided
  by `AbstractToken:hasUserChanged` if you do not need any custom comparison logic.
  In this case do not implement the interface and remove your comparison function.

  Before:

      class User implements UserInterface
      {
          // ...
          public function equals(UserInterface $user) { /* ... */ }
          // ...
      }

  After:

      class User implements UserInterface, EquatableInterface
      {
          // ...
          public function isEqualTo(UserInterface $user) { /* ... */ }
          // ...
      }