Using Archive

Use the factory when you want the framework-managed archive service.

Create a ZIP archive

use Quantum\Archive\Enums\ArchiveType;
use Quantum\Archive\Factories\ArchiveFactory;

$archive = ArchiveFactory::get(ArchiveType::ZIP);
$archive->setName(storage_dir() . '/exports/reports.zip');

$archive->addMultipleFiles([
    'app.php' => base_dir() . '/shared/config/app.php',
    'session.php' => base_dir() . '/shared/config/session.php',
]);

Create a PHAR archive

use Quantum\Archive\Factories\ArchiveFactory;

$archive = ArchiveFactory::get();
$archive->setName(storage_dir() . '/builds/app.phar');
$archive->addFromString('meta.txt', 'Build generated at deploy time');

Add directories and in-memory content

$archive->addEmptyDir('config');
$archive->addFromString('config/readme.txt', 'Package configuration files');

Extract an archive

$archive->extractTo(storage_dir() . '/tmp/unpacked');

For PHAR, you can also pass a selected file list or entry name as the second argument.

For ZIP, that second argument is currently ignored.

Delete entries

$archive->deleteFile('meta.txt');

$archive->deleteMultipleFiles([
    'config/readme.txt',
    'app.php',
]);

Access adapter-specific behavior

Use getAdapter() when you need a capability that is not part of the shared wrapper contract.

use Quantum\Archive\Adapters\PharAdapter;

$archive = ArchiveFactory::get();
$archive->setName(storage_dir() . '/builds/app.phar');

$adapter = $archive->getAdapter();

if ($adapter instanceof PharAdapter) {
    $adapter->removeArchive();
}

That pattern is safe only when you know which adapter the factory resolved.

Common pitfalls

• Forgetting setName() makes the first real operation fail.
• Reusing ArchiveFactory::get() later in the same process gives you the same archive instance for that adapter type.
• addMultipleFiles() is all-or-nothing only at the return-value level; if one later add fails, earlier files may already be in the archive.
• ZIP extractions always extract the full archive, even if you pass a file list.