README

除了合并PR之外，我已经很长时间没有更新这个包了。我最后一次使用这个包是在PHP5时。我存档了这个仓库，因为我不再使用PHP（我们有时都必须继续前进）而且没有时间再好好照顾它了。

请随意阅读代码，fork它或以任何你想要的方式使用它。

更新时间：2020年2月25日

我已经合并了一个PR，其中包括一个安全修复，以缓解zip目录遍历攻击。
这个包仍然被存档，应该用另一个包替换。
然而，只要还有安全修复，我就认为我有责任在需要时更新这个包。

Zipper

这是一个简单的Wrapper，用于封装ZipArchive方法并提供一些便捷的功能。

安装

将此包添加到composer.json中所需的包列表

对于Laravel 5："sunder6218/zipper": "1.0.x"
~~对于Laravel 4："sunder6218/zipper": "0.5.x"~~

运行composer update
转到app/config/app.php

添加到服务提供者Chumper\Zipper\ZipperServiceProvider::class
添加到别名'Zipper' => Chumper\Zipper\Zipper::class

现在您可以通过Zipper别名访问Zipper。

简单示例

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

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

另一个示例

$zipper = new \Chumper\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用户不应使用''作为whitelist/blacklist模式，因为这不会匹配任何内容

列入白名单

Zipper::WHITELIST

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

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

或列入黑名单

Zipper::BLACKLIST 这将把test.zip提取到public文件夹中，但zip中以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作为whitelist/blacklist参数，而没有设置Zipper::EXACT_MATCH，提取文件/文件夹时，如果没有设置Zipper::EXACT_MATCH，则会提取所有以给定字符串开头的文件和文件夹

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');

开发

也许添加其他压缩功能，如rar、phar或bzip2等是个好主意。一切都已经设置好了，如果你只想进一步开发，请fork并继续开发。

如果你需要其他功能或遇到错误，请在本地的github上提交issue。

τούν더6218 / zipper

维护者

详情