<?php

use Imponeer\ArchiveDownloadBuilder\ZipDownloader;

// Create ZIP downloader (uses entire filesystem as base when no filesystem is specified)
$downloader = new ZipDownloader();

// Add files from anywhere on the filesystem
$downloader->addFile('/path/to/document.pdf');
$downloader->addFile('/home/user/image.jpg', 'renamed-image.jpg');

// Add file data directly
$downloader->addFileData('Hello World!', 'hello.txt');

// Generate and download
$downloader->download('my-archive');

<?php

use Imponeer\ArchiveDownloadBuilder\ZipDownloader;
use League\Flysystem\Filesystem;
use League\Flysystem\Local\LocalFilesystemAdapter;

// Create filesystem adapter for a specific directory
$filesystem = new Filesystem(new LocalFilesystemAdapter('/path/to/files'));

// Create ZIP downloader with custom filesystem
$downloader = new ZipDownloader(filesystem: $filesystem);

// Add files to archive (paths are relative to the filesystem adapter)
$downloader->addFile('document.pdf');
$downloader->addFile('image.jpg', 'renamed-image.jpg');

// Add file data directly
$downloader->addFileData('Hello World!', 'hello.txt');

// Generate and download
$downloader->download('my-archive');

<?php

use Imponeer\ArchiveDownloadBuilder\TarDownloader;
use League\Flysystem\Filesystem;
use League\Flysystem\Local\LocalFilesystemAdapter;

// Create filesystem adapter
$filesystem = new Filesystem(new LocalFilesystemAdapter('/path/to/files'));

// Create TAR downloader
$downloader = new TarDownloader(filesystem: $filesystem);

// Add files to archive
$downloader->addFile('config.json');
$downloader->addBinaryFile('data.bin', 'backup-data.bin');

// Generate and download
$downloader->download('backup');

// Custom ZIP configuration
$zipDownloader = new ZipDownloader(
    ext: '.custom.zip',
    mimetype: 'application/custom-zip',
    filesystem: $filesystem
);

// Custom TAR configuration
$tarDownloader = new TarDownloader(
    ext: '.backup.tar.gz',
    mimetype: 'application/x-compressed-tar',
    filesystem: $filesystem,
    tmpPath: '/custom/temp/path'
);

use League\Flysystem\Filesystem;
use League\Flysystem\InMemory\InMemoryFilesystemAdapter;
use League\Flysystem\Ftp\FtpAdapter;
use League\Flysystem\AwsS3V3\AwsS3V3Adapter;

// In-memory filesystem
$memoryFs = new Filesystem(new InMemoryFilesystemAdapter());
$downloader = new ZipDownloader(filesystem: $memoryFs);

// FTP filesystem
$ftpFs = new Filesystem(new FtpAdapter($ftpConfig));
$downloader = new ZipDownloader(filesystem: $ftpFs);

// AWS S3 filesystem
$s3Fs = new Filesystem(new AwsS3V3Adapter($s3Client, $bucket));
$downloader = new ZipDownloader(filesystem: $s3Fs);

// Get PSR-7 response instead of direct download
$response = $downloader->toResponse('archive-name');

// Use with your favorite HTTP framework
// Symfony
return new Response($response->getBody(), $response->getStatusCode(), $response->getHeaders());

// Laravel
return response($response->getBody(), $response->getStatusCode(), $response->getHeaders());

// Slim Framework
return $response; // Direct usage

use League\Flysystem\FileAttributes;

// Add all files from a directory
foreach ($filesystem->listContents('/documents', true) as $item) {
    if ($item instanceof FileAttributes) {
        $downloader->addFile($item->path());
    }
}

// Add files with custom naming pattern
$files = ['report1.pdf', 'report2.pdf', 'summary.doc'];
foreach ($files as $index => $file) {
    $downloader->addFile($file, sprintf('report_%02d_%s', $index + 1, basename($file)));
}

use PhpZip\Exception\ZipException;
use League\Flysystem\FilesystemException;

try {
    $downloader = new ZipDownloader(filesystem: $filesystem);
    $downloader->addFile('nonexistent-file.txt');
    $downloader->download('archive');
} catch (FilesystemException $e) {
    // Handle filesystem errors (file not found, permission issues, etc.)
    echo "Filesystem error: " . $e->getMessage();
} catch (ZipException $e) {
    // Handle ZIP-specific errors
    echo "ZIP error: " . $e->getMessage();
}