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.
Comment: Reverted from v. 2



Note that the only two supported options are now FS and DFS. The DB cluster is deprecated, and doesn't exist in eZ Publish 5.1.

INI file

titleVersion >= 5.4

Note : this feature is available from 5.4 version

Configuration with INI file

A new INI setting, eZDFSClusteringSettings.DFSBackend, is introduced. It expects the name of a class that implements eZDFSFileHandlerDFSBackendInterface

Code Block


By default, the configured backend will be created with the new keyword, without any argument.

If complex initialization steps are required, backends can implement eZDFSFileHandlerDFSBackendFactoryInterface. This interface has a build() static method. Within the implementation, dependencies can be resolved, and configuration loaded.


Due to the order of settings parsing, cluster related settings must be placed in the global file.ini override, and not in an extension or a siteaccess.

Web server

As for legacy, rewrite rules are required in order to serve files stored in a DFS cluster. The virtualhost setup documentation provides the required rules.