By default, files will be stored inside a directory that uses the
id of its
Media-object as a name. Converted images will be stored inside a directory named
Putting files inside their own folders guarantees that files with the same name can be added without any problems.
To override this default folder structure, a class that conforms to the
PathGenerator-interface can be specified as the
custom_path_generator_class in the config file.
Let's take a look at the interface:
public function getPath(Media $media): string;
public function getPathForConversions(Media $media): string;
This example from the tests uses
the md5 value of media-id to name directories. The directories where conversions are stored will be named
c instead of the default
There aren't any restrictions on how the directories can be named. When a
Media-object gets deleted the package will delete its entire associated directory. To avoid tears or worse, make sure that every media gets stored its own unique directory.