Repository files navigation

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 usingPHP ZipArchive.

Require this package in your composer.json and update composer. This will download the package.

composer require zanysoft/laravel-zip

After updating composer, add the ServiceProvider to the providers array in config/app.php

ZanySoft\Zip\ZipServiceProvider::class,

You can optionally use the facade for shorter code. Add this to your facades:

'Zip' => ZanySoft\Zip\Facades\Zip::class,

useZanySoft\Zip\Zip class only useZip is made to handle a zip file.

• include the Zip class at top:

useZip;

• 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\ZanySoft\Zip\ZipManager can handle multipleZanySoft\Zip\Zip objects.

• include the Zip and ZipManager class at top:

useZanySoft\Zip\ZipManager;useZip;

• Init the manager and register Zips:

  // init manager$manager =newZipManager();// 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 =newZipManager();// 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();