Chain Loader

Edit this page

The Chain data loader doesn't load the image binary itself; instead it allows for loading the image binary using any number of other configured data loaders. For example, if you configured both a filesystem and flysystem data loader, this loader can be defined to load from both in a defined order, returning the image binary from the first that responds.

Tip

This loader iterates over the data loaders in the order they are configured in the chain definition, returning an image binary from the first loader that supports the passed file path. This means if a file exists in more than one loader, the file will be returned using the first one defined in your configuration file for this chain loader.

Configuration

As this loader leverages any number of other configured loaders, its configuration consists only of the list of loaders to try in succession:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# app/config/config.yml

liip_imagine:
    loaders:
        foo:
            filesystem:
                # configure filesystem loader

        bar:
            flysystem:
                # configure flysystem loader

        baz:
            stream:
                # configure stream loader

        qux:
            chain:
                # use the "foo", "bar", and "baz" loaders
                loaders:
                    - foo
                    - bar
                    - baz
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.
TOC
    Version