.. _upgrading.2-to-3: ============== Version 2 to 3 ============== While we have made significant internal changes to the library, we have made every effort to ensure a seamless upgrade path from the 2.x series of this library to 3.x. One major breaking change is the transition from the ``Rhumsaa`` root namespace to ``Ramsey``. In most cases, all you will need is to change the namespace to ``Ramsey`` in your code, and everything will "just work." .. note:: For more details on the namespace change, including reasons for the change, read the blog post "`Introducing ramsey/uuid <https://benramsey.com/blog/2016/04/ramsey-uuid/>`_". Here are full details on the breaking changes to the public API of this library: 1. All namespace references of ``Rhumsaa`` have changed to ``Ramsey``. Simply change the namespace to ``Ramsey`` in your code and everything should work. 2. The console application has moved to `ramsey/uuid-console <https://packagist.org/packages/ramsey/uuid-console>`_. If using the console functionality, use Composer to require ``ramsey/uuid-console``. 3. The Doctrine field type mapping has moved to `ramsey/uuid-doctrine <https://packagist.org/packages/ramsey/uuid-doctrine>`_. If using the Doctrine functionality, use Composer to require ``ramsey/uuid-doctrine``.