Download the PHP package elgigi/flysystem-useful-adapters without Composer

FlysytemUsefulAdapters

This extension adds some useful adapters for the league/flysystem library.

Installation

You can install the client with Composer:

Adapters

FallbackAdapter

The FallbackAdapter allows you to read from or write to a fallback adapter when the primary one fails.

Imagine that your main adapter is an S3 bucket in an unavailable region; to continue to receive files from your customers, you can use a fallback adapter on another region.

Adapters are tried in the order they are given until one succeeds. If every adapter throws, the last exception is rethrown.

IgnoreFilesystemAdapter

The IgnoreFilesystemAdapter decorates an adapter and filters entries based on .gitignore-style ignore files (e.g. .docignore). Patterns follow the gitignore syntax (negation with !, anchoring with /, **, directory-only with a trailing /, character classes…) and are resolved as a cascade: an ignore file placed in a subdirectory applies to that subtree, overriding the rules of parent directories.

The third argument $strict (default true) controls how ignored paths behave:

• $strict = true: an ignored path is treated as if it does not exist for every operation (read/write/metadata throw the relevant exception, fileExists returns false, delete is a no-op).
• $strict = false: only listContents() is filtered; direct accesses are passed through to the inner adapter.

The ignore files themselves are always hidden from listContents() but remain readable.

LogAdapter

The LogAdapter is compliant with psr/log and allows you to log actions performed on a filesystem.

Each operation is logged with a level that depends on its nature: write-type operations (write, writeStream, copy, move, delete, deleteDirectory, createDirectory, setVisibility) are logged at the notice level, read and metadata operations at the debug level, and any failure at the error level.

ReadWriteAdapter

The ReadWriteAdapter allows you to separate reader and writer adapters.

Write methods (write, writeStream, delete, copy, move, createDirectory, deleteDirectory, setVisibility) are routed to the writer adapters, while all other (read/metadata) methods are routed to the reader adapters. Readers are automatically wrapped as read-only to ensure no write happens through them. At least one reader and one writer are required.

RetryAdapter

The RetryAdapter allows you to retry an action on a filesystem in case of failure, after a delay and a given number of times.

The second argument $time is the delay between attempts, in milliseconds (default 5000). The third argument $retry is the total number of attempts (default 2, minimum 1). The fourth argument $multiplier (default 1.0, minimum 1) applies an exponential backoff: the delay for attempt n is time * multiplier^n (e.g. with time: 1000 and multiplier: 2.0, delays are 1000 ms, then 2000 ms, then 4000 ms…). A multiplier of 1.0 keeps a constant delay. No delay is applied after the last attempt; if all attempts fail, the last exception is rethrown.