Batch interface

[shyim]

Feature Request

Scenario / Use-case

I want to copy 8k files to an external FS. This is right now pretty unuseable with Flysystem as the interface only allows one copy at once. So I cannot take any advantage of the real adapter, like async copying at once and so on.

My suggestion so far would be to have a interface: BatchFilesystemOperator which introduces new methods like:

writeBatch and takes a list of files and the adapter is able to write these files in a automatic.

when the adapter does not have this interface, we can just call the regular write in a loop.

interface BatchFilesystemOperator
{
    /**
     * @param array<string, resource> $files
     */
    public function writeBatch(array $files);
}

/**
     * @param array<string, resource> $files
     */
    public function writeBatch(array $files): void
    {
        if ($this->adapter instanceof BatchFilesystemOperator) {
            $this->adapter->writeBatch($files);
            return;
        }

        foreach ($files as $location => $contents) {
            $this->writeStream($location, $contents);
        }
    }

In the example AsyncAWS s3 adapter, we can implement this method and make use of async requests to make this faster for this adapter.

[frankdejonge]

Sounds like a reasonable addition, I've labelled it V4. I'll create a 4.x branch some time this week to start tracking it.

[shyim]

Let me know if I can help you in some way :). We did an ugly hack right now, would like to get rid of it 👍
https://github.com/shopware/shopware/blob/trunk/src/Core/Framework/Adapter/Filesystem/Plugin/CopyBatch.php#L72