Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
   eZ Publish 4.x / legacy

eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Skip to end of metadata
Go to start of metadata

Given that eZ Publish (5.x series) was created before PHP 7 came out, there are a few things to be aware of and consider when you want to run it on PHP 7.

Alternative: Running eZ Platform & eZ Platform Enterprise with Legacy Bridge

Did you know that you can also consider running eZ Publish legacy side by side with eZ Platform, and that this is supported together with eZ Publish Enterprise? It provides new features, improved security, simplified migration paths, fully supports PHP 7 (including 7.2 and higher), and can be a good alternative to 5.4 which does not receive new features anymore.

Why PHP 7.2 and higher won't be officially supported on 5.4

PHP 7.x series has added more and more deprecations to cleanup the language for each new release. As 5.4 is a stable release, and one that has a legacy from way before PHP7 came to be, we can not risk BC breaks on 5.4 by attempting to fix these deprecations. However in the newer feature releases of eZ Publish legacy, support for this is progressively being added by both eZ and the community, making upgrading to eZ Platform 2.5LTS + legacy bridge 2.x + eZ Publish legacy 2019.03.x a viable alternative, if you are up for small adapting your own extensions for changes in PHP as well.

So while we will try to make sure 5.4 is able to boot on higher version of PHP 7.x, it won't be officially supported for use 7.2 and higher in production. In practice this means if you hit issues which can be attributed to PHP version, and we can't fix it without breaking BC, then we will ask you to either upgrade eZ install or downgrade PHP.

Deprecation warnings

eZ Platform, including platform parts bundled with eZ Publish Platform 5.x, was made for more recent versions of PHP and tested for it early on. eZ Publish legacy, on the other hand, was first created back in 2001 and has a long range of extensions built for it closely depending on how it was written. And as eZ Publish is considered mature software, backwards compatibility breaks are avoided as much as possible. This means that there are a few deprecation warnings to be expected when running eZ Publish (legacy) on PHP 7 which won't be fixed as they risk breaking extensions. This includes:

  • Class constructor names, example:

    "Methods with the same name as their class will not be constructors in a future version of PHP; eZContentObjectVersion has a deprecated constructor"

Importance of testing when upgrading to PHP7

PHP7 is a large change to the PHP language, and while it does provide a real world 2x - 2.6x improvement in performance, we can not stress enough the importance of testing your whole site/application when upgrading. You should essentially regard it as a re-launch.


  1. We try our best to cover all possible cases, especially in eZ Platform, our newest version. However, our QA and automated testing does not cover all the possible use case or hardware and software combinations you might be using eZ Publish with.
  2. Extensions made by the community and shared on or other places (github/composer, ...) might or might not have tested on PHP 7 yet.
  3. Your own code base, including all your extensions, will need to be adapted for PHP 7.

So as a Partner make sure to stay on top of this when switching to PHP7. Make sure to gradually phase it in for development, then staging/acceptance/qa environment, before upgrading production environment. And if in doubt, we are here to help!

  • No labels


  1. Unknown User (remy_php)

    Requirements 5.4 : PHP scripting language: 5.4/5.5/5.6/7.x (minimum 5.4.4)

    However, it seems that version 2014.11 (which is the Community equivalent of 5.4) is not compatible with php7.0.

    Maybe the documentation should be updated ..

  2. Hi Unknown User (remy_php),

    2014.11 is more or less the equivalent of v5.4.0, but it has not evolved after 2014, including no security fixes. Support for PHP7 was introduced in eZ Publish Enterprise v5.4.7 and afterwards.
    However the new eZ Publish legacy 2017.08 and higher releases which are both for community, and for eZ Platform Enterprise users using legacy bridge for migration scenarios, fully supports PHP7, and are available via composer.


    Blog post about it:

    So if you look to upgrade to the equivalent of 5.4/2014.11 of eZ Platform + legacy on PHP 7.x, it's actually not that different for many previous eZ Publish upgrades. Follow the migration doc, and install legacy bridge, however skip parts about migrating xmltext and flow field types and instead continue to run using legacy data types. Besides getting full support for PHP7, you also get some newer features in both legacy and especially platform stack, including possibility to test out eZ Platform Admin a bit (it  just won't support your legacy field types).