Download the PHP package ezsystems/ezdfs-fsbackend-dispatcher without Composer
On this page you can find all versions of the php package ezsystems/ezdfs-fsbackend-dispatcher. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ezsystems/ezdfs-fsbackend-dispatcher
More information about ezsystems/ezdfs-fsbackend-dispatcher
Files in ezsystems/ezdfs-fsbackend-dispatcher
Package ezdfs-fsbackend-dispatcher
Short Description eZ Publish Dispatcher DFS backend
License GPL-2.0
Informations about the package ezdfs-fsbackend-dispatcher
DFS Cluster DFS Dispatcher
What is it ?
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.
Actual handlers
An AWS-S3 handler, that stores binary files to Amazon S3, is available: http://github.com/ezsystems/ezdfs-fsbackend-aws-s3.
Requirements
- 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)
Installation
Using composer
It can be installed via composer from eZ Publish, new stack or legacy:
Or by adding "ezsystems/ezdfs-fsbackend-dispatcher": "~1.0@beta"
to your project's composer.json.
Configuration
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 settings/override/file.ini.append.php
, or
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 eZDFSFileHandlerDFSBackend
.
Backends initialization
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 build()
method.
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:
Remember that DefaultBackend
must be explicitly configured in the global override to be taken into account.