README

这是从chumper/zipper原始包的分支

这是一个简单的包装，围绕ZipArchive方法和一些实用功能。

安装

Laravel 7.x/8.x

$ composer require appoly/zipper

现在您可以使用Zipper别名访问Zipper。

简单示例

$files = glob('public/files/*');
Zipper::make('public/test.zip')->add($files)->close();

• 默认情况下，该包将在项目路由文件夹中创建test.zip，但在上面的示例中，我们将其更改为project_route/public/。

另一个示例

$zipper = new \Appoly\Zipper\Zipper;

$zipper->make('test.zip')->folder('test')->add('composer.json');
$zipper->zip('test.zip')->folder('test')->add('composer.json','test');

$zipper->remove('composer.lock');

$zipper->folder('mySuperPackage')->add(
    array(
        'vendor',
        'composer.json'
    ),
);

$zipper->getFileContent('mySuperPackage/composer.json');

$zipper->make('test.zip')->extractTo('',array('mySuperPackage/composer.json'),Zipper::WHITELIST);

$zipper->close();

注意：请记住，您需要在末尾调用->close()以将zip文件写入磁盘。

您可以将大多数功能轻松地链接起来，除了getFileContent、getStatus、close和extractTo，这些必须在链的末尾。

我编写这个小包的主要原因是因为extractTo方法，因为它允许您在解压缩zip时非常灵活。因此，您可以实现一个更新方法，该方法将仅覆盖已更改的文件。

函数

make($pathToFile)

创建或打开zip存档；如果文件不存在，它将创建一个新文件。它将返回Zipper实例，以便您可以轻松地进行链式操作。

add($files/folder)

您可以为文件或文件夹添加一个文件数组，或者添加一个文件夹，然后该文件夹中的所有文件都将被添加。因此，从第一个示例中，我们也可以这样做：$files = 'public/files/';。

addString($filename, $content)

通过指定名称和内容作为字符串将单个文件添加到zip中。

remove($file/s)

从zip中删除单个文件或文件数组。

folder($folder)

指定一个文件夹以“添加文件到”或“从zip中删除文件”，例如

Zipper::make('test.zip')->folder('test')->add('composer.json');
Zipper::make('test.zip')->folder('test')->remove('composer.json');

listFiles($regexFilter = null)

列出存档中的所有文件（如果没有提供过滤模式）。使用$regexFilter参数来过滤文件。请参阅模式语法以了解正则表达式语法

注意：listFiles忽略使用folder函数设置的文件夹

示例：返回所有以'.log'模式结尾/不结尾的文件/文件夹（不区分大小写）。这将返回子文件夹及其子文件夹中的匹配项

$logFiles = Zipper::make('test.zip')->listFiles('/\.log$/i'); 
$notLogFiles = Zipper::make('test.zip')->listFiles('/^(?!.*\.log).*$/i'); 

home()

重置文件夹指针。

zip($fileName)

使用ZipRepository进行文件处理。

getFileContent($filePath)

获取zip中的文件内容。这将返回内容或false。

getStatus()

获取zip的打开状态为整数。

close()

关闭zip并写入所有更改。

extractTo($path)

将zip存档的内容提取到指定的位置，例如

Zipper::make('test.zip')->folder('test')->extractTo('foo');

这将在zip文件中的test文件夹中进行，并将该文件夹的内容仅提取到foo文件夹中，这与使用Zipper::WHITELIST相同。

此命令非常实用，可以仅获取zip文件的一部分，您还可以传递第二个和第三个参数来指定单个或文件数组，这些文件将被

注意：Php ZipArchive 在内部使用 '/' 作为 zip 文件夹中的文件/文件夹的分隔符。因此，Windows 用户不应使用 '' 作为白名单/黑名单模式，因为这不会匹配任何内容

白名单

Zipper::WHITELIST

Zipper::make('test.zip')->extractTo('public', array('vendor'), Zipper::WHITELIST);

这将把 test.zip 提取到 public 文件夹中，但 只有 以 vendor 前缀开始的文件/文件夹会被提取。

或黑名单

Zipper::BLACKLIST 这将把 test.zip 提取到 public 文件夹中，但 vendor 前缀开始的文件/文件夹将不会被提取。

Zipper::make('test.zip')->extractTo('public', array('vendor'), Zipper::BLACKLIST);

Zipper::EXACT_MATCH

Zipper::make('test.zip')
    ->folder('vendor')
    ->extractTo('public', array('composer', 'bin/phpunit'), Zipper::WHITELIST | Zipper::EXACT_MATCH);

这将把 test.zip 提取到 public 文件夹中，但 只有 名称完全匹配的文件/文件夹。所以这会

• 将名为 composer 的文件或文件夹从 zip 中的 vendor 文件夹提取到 public，结果为 public/composer
• 将名为 bin/phpunit 的文件或文件夹从 zip 中的 vendor/bin/phpunit 文件夹提取到 public，结果为 public/bin/phpunit

注意：当 zip 的结构如下，并且只给出了 test.bat 作为白名单/黑名单参数时，不设置 Zipper::EXACT_MATCH 提取 zip 中的文件/文件夹。这样，extractTo 会提取所有以给定字符串开头的文件和文件夹

test.zip
 |- test.bat
 |- test.bat.~
 |- test.bat.dir/
    |- fileInSubFolder.log

extractMatchingRegex($path, $regex)

从 zip 存档中匹配正则表达式的内容提取到指定的位置。请参阅 模式语法 了解正则表达式的语法。

示例：从 src 文件夹及其子文件夹中提取所有以 .php 结尾的文件。

Zipper::make('test.zip')->folder('src')->extractMatchingRegex($path, '/\.php$/i'); 

示例：从 src 文件夹及其子文件夹中提取所有 除了 以 test.php 结尾的文件。

Zipper::make('test.zip')->folder('src')->extractMatchingRegex($path, '/^(?!.*test\.php).*$/i');