laravel-zip is the world's leading zip utility for file compression and backup.
This library was written to simplify and automate Zip files management using PHP ZipArchive.
Require this package in your composer.json and update composer. This will download the package.
composer require dcorreah/laravel-zip
After updating composer, add the ServiceProvider to the providers array in config/app.php
dcorreah\Zip\ZipServiceProvider::class,
You can optionally use the facade for shorter code. Add this to your facades:
'Zip' => dcorreah\Zip\Facades\Zip::class,
use dcorreah\Zip\Zip
class only use Zip
is made to handle a zip file.
- include the Zip class at top:
use dcorreah\Zip\Facades\Zip;
-
Open zip file:
$zip = Zip::open('file.zip');
-
Create zip file:
$zip = Zip::create('file.zip');
-
Check zip file:
$is_valid = Zip::check('file.zip');
-
Extract zip file:
// extract whole archive $zip->extract('/path/to/uncompressed/files'); // extract a file $zip->extract('/path/to/uncompressed/files', 'file'); // extract multiple files $zip->extract('/path/to/uncompressed/files', array('file1','file2'));
-
Check if zip has a file:
// Check if archive has a file $zip->has('/path/to/file/in/archive'); // Check if archive has a file case insensitively $zip->has('/path/to/file/in/archive', ZipArchive::FL_NOCASE); // Check if archive has a file ignoring directory component $zip->has('file', ZipArchive::FL_NODIR); // Check if archive has a file case insensitively ignoring directory component $zip->has('file', ZipArchive::FL_NOCASE|ZipArchive::FL_NODIR);
-
Add a file/directory to zip:
$zip->add('/path/to/my/file'); // declaring path $zip->setPath('/path/to/my')->add('file'); // add directory $zip->add('/path/to/my/directory'); // add directory (only its content) $zip->add('/path/to/my/directory', true);
-
Add content to zip:
$zip->addFromString('file name with extension', 'content of file'); $zip->addFromString('filename.txt', $file_content); $zip->addFromString('folder/file1.txt', $file_content); $zip->addFromString('folder/file2.txt', $file_content);
-
Add multiple files/directories to zip:
// using array as parameter $zip->add( array('/path/to/my/file1', '/path/to/my/file2'); // chaining methods $zip->add('/path/to/my/file1')->add('/path/to/my/file2'); // declaring path $zip->setPath('/path/to/my')->add('file1')->add('file2');
-
Delete a file/directory from zip:
$zip->delete('file');
-
Delete multiple files/directories from zip:
// using array as parameter $zip->delete( array('file1', 'file2') ); // chaining methods $zip->delete('file1')->delete('file2');
-
List content of zip file
$zip->listFiles();
-
Close zip file
$zip->close();
-
Skip hidden files while adding directories:
// set mode $zip->setSkipped('HIDDEN'); // get mode $mode = $zip->getSkipped();
-
Use password for zip extraction:
// set password $zip->setPassword('slartibartfast'); // get password $password = $zip->getPassword();
-
Use a mask != 0777 for created folders:
// set mask $zip->setMask(0644); // get mask $mask = $zip->getMask();
The \dcorreah\Zip\ZipManager
can handle multiple dcorreah\Zip\Zip
objects.
- include the Zip and ZipManager class at top:
use dcorreah\Zip\ZipManager;
use dcorreah\Zip\Facades\Zip;
-
Init the manager and register Zips:
// init manager $manager = new ZipManager(); // register existing zips $manager->addZip( Zip::open('/path/to/my/file1.zip') ) ->addZip( Zip::open('/path/to/my/file2.zip') ); // register a new zip $manager->addZip( Zip::create('/path/to/my/file3.zip') );
-
Basic zips management:
// get a list of registered zips $list = $manager->listZips(); // remove a zip $manager->removeZip($ZipObject); // get a Zip $zip = $manager->getZip(0);
-
Add files to all zips:
$manager = new ZipManager(); // register existing zips $manager->addZip( Zip::open('/path/to/my/file1.zip') ) ->addZip( Zip::open('/path/to/my/file2.zip') ); // register a new zip $manager->addZip( Zip::create('/path/to/my/file3.zip') );
-
Extract zips:
// separate content in folders $extract = $manager->extract('/path/to/uncompressed/files', true); // use a single folder $extract = $manager->extract('/path/to/uncompressed/files', false); // extract single file $extract = $manager->extract('/path/to/uncompressed/files', false, 'file'); // extract multiple files $extract = $manager->extract('/path/to/uncompressed/files', false, array('file1','file2'));
-
Merge zips:
// separate content in folders $manager->merge('/path/to/output/file.zip', true); // flatten files $manager->merge('/path/to/output/file.zip', false);
-
Close zips:
$manager->close();
-
Declare path from which add files:
// set path $zip->setPath('/path/to/files'); // get path $path = $zip->getPath();
-
Use a mask != 0777 for created folders
// set masks $manager->setMask(0644); // get masks $mask = $manager->getMask();