This is the documentation for
v8 but the latest version is
v10
.
You can switch versions in the menu on the left/at the top.
Check your current version with the following command:
composer show spatie/laravel-medialibrary
You might want to let users be able to download multiple files at once. Traditionally you'd have to create a zip archive that contains the requested files.
The media library is able to zip stream multiple files on the fly. So you don't need to create a zip archive on your server.
The provided MediaStream
class that allows you to respond with a stream. Files will be zipped on the fly and you can even include files from multiple filesystems.
Here's an example on how it can be used:
use Spatie\MediaLibrary\Support\MediaStream;
class DownloadMediaController
{
public function download(YourModel $yourModel)
{
// Let's get some media.
$downloads = $yourModel->getMedia('downloads');
// Download the files associated with the media in a streamed way.
// No prob if your files are very large.
return MediaStream::create('my-files.zip')->addMedia($downloads);
}
}
You can also pass any custom options to the ZipStream
instance using the useZipOptions
method.
All the available options are listed on the ZipStream-PHP wiki.
Here's an example on how it can be used:
use Spatie\MediaLibrary\Support\MediaStream;
use ZipStream\Option\Archive as ArchiveOptions;
class DownloadMediaController
{
public function download(YourModel $yourModel)
{
// Let's get some media.
$downloads = $yourModel->getMedia('downloads');
// Download the files associated with the media in a streamed way.
// No prob if your files are very large.
return MediaStream::create('my-files.zip')
->useZipOptions(function(ArchiveOptions $zipOptions) {
$zipOptions->setZeroHeader(true);
})
->addMedia($downloads);
}
}