Upgrading eZ Platform to v3.0¶
The following upgrade documentation describes how to upgrade eZ Platform from v2.5 to v3.0.
If you are upgrading from a version lower than v2.5, follow the standard update procedure first. Do not proceed with an upgrade to v3.0 before you complete an update to v2.5.
Familiarize yourself with a new project structure¶
The latest Symfony versions changed the organization of your project into folders and bundles. When updating to eZ Platform v3 you need to move your files and modify file paths and namespace references.
Configuration files have been moved from
Package-specific configuration is placed in
This folder also contains
config/packages/ezplatform.yaml, which contains all settings coming in from Kernel.
PHP code and bundle organization¶
Since Symfony 4
src/ code is no longer organized in bundles,
AppBundle has been removed from the default eZ Platform install.
In order to adapt, you'll need to move all your PHP code, such as controllers or event listeners, to the
src folder and use the
App namespace for your custom code instead.
How to make AppBundle continue to work, for now
Refactoring bundles for
src/ folder can involve extensive changes, if you want to make your
src/AppBundle continue to work, follow an Autoloading src/AppBundle guide on Symfony Casts.
1 2 3
Once you are ready to refactor the code to
App namespace, follow Bye Bye AppBundle article.
Templates are no longer stored in
You need to move all your templates to the
templates folder in your project's root.
Translation files have been moved out of
translations in your project's root.
web and assets¶
Content of the
web folder is now placed in
app/Resources/assets has been moved to
You also need to update paths that refer to the old location,
for example in