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

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
November FIXME 2015

eZ announces the availability of 5.4.5, a maintenance release available for all users of eZ Publish Platform 5.4.

titleInstalling the RC

To be able to get access to the beta you will have to change stability flag on affected/added packages (Solr and Recommendation are optional new packages, ezfind depends if you're using it):

Code Block
composer require --no-update "ezsystems/ezpublish-kernel:5.4.5-rc1 as 5.4.5"
composer require --no-update "ezsystems/ezpublish-legacy:5.4.5-rc1 as 5.4.5"
composer require --no-update "ezsystems/ezflow-ls-extension:5.3.8-rc1 as 5.3.8"
# optional
composer require --no-update "ezsystems/ezfind-ls:5.4.5-rc1 as 5.4.5"
composer require --no-update "ezsystems/ezplatform-solr-search-engine:~1.0.0@rc"
composer require --no-update "ezsystems/recommendation-bundle:~1.0.0@beta"

After this has been done follow the 5.4.x Update Instructions to apply this update to your platforms, including the following items:

  • edit ezpublish/EzPublishKernel.php, and instantiate eZ\Bundle\EzPublishLegacySearchEngineBundle\EzPublishLegacySearchEngineBundle to in the list of enabled bundles in the $bundles array in the registerBundles() method, right before EzPublishLegacyBundle.
  • if you have installed ezsystems/ezplatform-solr-search-engine, instantiate EzSystems\EzPlatformSolrSearchEngineBundle\EzSystemsEzPlatformSolrSearchEngineBundle at the end of the $bundles array in the registerBundles() method.
  • if you have installed ezsystems/recommendation-bundle, instantiate EzSystems\RecommendationBundle\EzSystemsRecommendationBundle at the end of the $bundles array in the registerBundles() method.


Every package manually updated in the root composer.json must be added the update line specified in the 5.4.x update instructions. Add ezsystems/ezflow-ls-extension to the line. If the optional packages must be installed, add them as well: ezsystems/ezplatform-solr-search-engine recommendation-bundle ezsystems/ezfind-ls.

If they are omitted, composer will fail with a dependencies error.


After executing `composer update`, further actions are needed for Solr Search Engine Bundle, and Recommendation Bundle in order to correctly install them.


Highlights: New Features

This maintenance release introduces two new eZ Platform features to 5.4.x: Solr Search Engine Bundle and Recommendations Bundle, besides this there are several maintenance issues fixed as listed below both coming from support issues and pull requests from community.


Improved Search engine powered by Solr


New in 5.4.5, and part of the upcoming eZ Platform release this fall, is support for running API Search queries on top of Solr instead of SQL based search engine (specifically "Legacy" search/storage engine). As Search is essentially powering all Search and Querying ("fetch") operations in Platform stack (aka 5.x/Symfony stack), this specifically means you can expect much more stable performance from your searches and your system*, and much better possibility to scale out for your search needs using Solr.


'* See 5.x Architecture diagram for further information about how persistence load operations are cached by Persistence Cache, and Search queries now are delegated to Solr, meaning database is less affected by system load to mainly deal with content updates.

Further reading: Installation documentation for Solr Search Engine, developer info and source code in our Solr Search Engine Bundle repository, and further resources on Apache Solr.

Package Details

Resolving known issues

Known for both Solr and Recommendation:

  • Exception if Binary files in database has invalid path prefix
    • Make sure ezpublish.yml configuration var_dir is configured properly, and that you specify siteaccess when indexing content for Solr via command line.
  • Exception on unsupported Field Types
    • Make sure to configure all FieldTypes (datatypes) in your installation as NullType
  • Content not immediately available 
    • Solr Search Engine Bundle is on purpose not committing changes on Repository updates, but letting you control this using Solr configuration.
      Adjust Solr autoSoftCommit to control this.
    • For Recommendation service same is the true, 

If you still have problems, pop into our Slack channel at to discuss.

Package updates

Here are the ezsystems packages that have received an update as part of this release:

packageversionprior version

Updates and fixes in this release

servereZ Systems JIRA tracker
jqlQueryproject=EZP AND fixVersion in ( "5.4.5" ) ORDER BY issuetype DESC, key ASC