UPGRADE-3.x.md

UPGRADE 3.x

UPGRADE FROM 3.X to 3.X

Closed API

Many classes have been made final, meaning you can no longer extend them. Consider using decoration instead.

UPGRADE FROM 3.23 to 3.24

Deprecate API

Integration with FOSRest, JMS Serializer and Nelmio Api Docs is deprecated, the ReST API provided with this bundle will be removed on 4.0.

If you are relying on this, consider moving to other solution like API Platform instead.

UPGRADE FROM 3.22 to 3.23

Sonata Cache-bundle

SonataCacheBundle was upgraded from 2.x to 3.x. Because of the change in the CacheAdapterInterface, technically there are few BC-break in this project:

• BlockEsiCache and BlockSsiCache constructor signatures have changed.
• Some methods of BlockEsiCache, BlockJsCache and BlockSsiCache have now return type declaration.

If you override any of these classes make sure you are explicitly declaring your dependency with sonata-project/cache-bundle in your composer.json in order to avoid unwanted upgrades.

UPGRADE FROM 3.18.0 to 3.19.0

SonataEasyExtends is deprecated

Registering SonataEasyExtendsBundle bundle is deprecated, it SHOULD NOT be registered. Register SonataDoctrineBundle bundle instead.

UPGRADE FROM 3.3 to 3.4

Unused command option

The --all option of sonata:page:update-core-routes command is not used and is now deprecated.

UPGRADE FROM 3.1 to 3.2

Tests

All files under the Tests directory are now correctly handled as internal test classes. You can't extend them anymore, because they are only loaded when running internal tests. More information can be found in the composer docs.

Deprecations

The SnapshotManager::getPageByName method is deprecated and will be removed with the next major release.