eZ Publish Dispatcher DFS backend
This extension by itself won't provide any new end-user feature.
This extension provides a custom DFSBackend that dispatches calls to any DFS backend to a backend from a custom list, based on the path of the file.
It makes it possible to store some storage subdirectories to custom handlers, such as a cloud based one.
An AWS-S3 handler, that stores binary files to Amazon S3, is available: http://github.com/ezsystems/ezdfs-fsbackend-aws-s3.
- eZ Publish master (5.4.0-dev or 2014.05).
- eZ DFS configured (NFS itself doesn't matter, a local directory will work just as fine)
It can be installed via composer from eZ Publish, new stack or legacy:
composer require "ezsystems/ezdfs-fsbackend-dispatcher:~1.0@beta"
Or by adding
"ezsystems/ezdfs-fsbackend-dispatcher": "~1.0@beta" to your project's composer.json.
Due to INI settings loading order limitations, some settings can't be stored into extension INI files but in a global override.
The contents of the settings/file.ini.append.php file must be copied to
obviously merged into it, since it should already exist.
Backends are configured by adding their class name to the DFSBackends array in file.ini. This will make the dispatcher send
operations on files with a path starting with
var/ezdemo_site/storage/images to MyCustomBackend.
Priority is a simple first-come, first-served. Path that aren't matched by any path in
PathBackends are handled by
DispatchableDFS.DefaultBackend, by default set to the native
By default, backends are instanciated with a simple "new $class". But if a backend implements
eZDFSFileHandlerDFSFactoryBackendInterface interface, it will be built by calling the static
If any kind of initialization or injection is required, it can be done in this method.
A typical settings/override/file.ini.append.php with a custom handler enabled would look like this:
[ClusteringSettings] FileHandler=eZDFSFileHandler [eZDFSClusteringSettings] MountPointPath=/media/nfs DFSBackend=eZDFSFileHandlerDFSDispatcher DBHost=cluster_server DBName=db_cluster DBUser=root DBPassword= MetaDataTableNameCache=ezdfsfile_cache [DispatchableDFS] DefaultBackend=eZDFSFileHandlerDFSBackend PathBackends[var/site/storage/images]=MyCustomBackend
DefaultBackend must be explicitly configured in the global override to be taken into account.