PHP自带ZIP压缩、解压缩类ZipArchiv介绍及使用

--------------------- 使用ZipArchive对象的前提 ---------------------

要使用该PHP扩展类，需要(PHP 5 >= 5.2.0, PECL zip >= 1.1.0)，部分方法需要 PHP 5.2.+，且php.ini配置支持zip
对于win系统，直接去掉php_zip.dll 扩展的注释，然后重启http服务（IIS或Apache）即可
Linux还没有试验，理论上差别不会很大

功能：
1、解压缩zip文件
2、将文件压缩成zip文件
3、追加文件到zip文件
4、将文件夹打包成zip文件（需要循环添加文件与创建空文件夹）
5、删除压缩文件中的条目

--------------------- ZipArchive对象常用方法介绍 ---------------------

测试约定：
测试文件为text.zip，该压缩文件包含了三个被压缩的文件（hello.txt、word.txt、ooxx.jpg），如下所示
text.zip
    hello.txt
    word.txt
    ooxx.jpg

打开zip文件，以便进一步操作
ZipArchive::open
(PHP 5 >= 5.2.0, PECL zip >= 1.1.0)
mixed ZipArchive::open ( string $filename [, int $flags ] )
第2个参数讲解
ZIPARCHIVE::OVERWRITE    总是创建一个新的文件，如果指定的zip文件存在，则会覆盖掉
ZIPARCHIVE::CREATE        如果指定的zip文件不存在，则新建一个
ZIPARCHIVE::EXCL        如果指定的zip文件存在，则会报错   
ZIPARCHIVE::CHECKCONS
返回值：
如果返回值等于下面的属性，表示对应的错误 或者 返回TRUE
$res == ZipArchive::ER_EXISTS    File already exists.（文件已经存在）
$res == ZipArchive::ER_INCONS    Zip archive inconsistent.（压缩文件不一致）
$res == ZipArchive::ER_INVAL    Invalid argument.（无效的参数）
$res == ZipArchive::ER_MEMORY    Malloc failure.（内存错误？这个不确定）
$res == ZipArchive::ER_NOENT    No such file.（没有这样的文件）
$res == ZipArchive::ER_NOZIP    Not a zip archive.（没有一个压缩文件）
$res == ZipArchive::ER_OPEN        Can't open file.（不能打开文件）
$res == ZipArchive::ER_READ        Read error.（读取错误）
$res == ZipArchive::ER_SEEK        Seek error.（查找错误）
<?php
$zip = new ZipArchive;
$res = $zip->open('test.zip');
if ($res === TRUE) {
    echo 'ok';
    //解压缩到test文件夹
    $zip->extractTo('test');
    $zip->close();
} else {
    echo 'failed, code:' . $res;
}
?>
    
根据压缩文件内的列表索引，返回被压缩文件的名称
ZipArchive::getNameIndex
string ZipArchive::getNameIndex ( int $index [, int $flags ] )
<?php
$zip = new ZipArchive();
$res = $zip->open('test.zip');
if ($res === TRUE) {
    var_dump($zip->getNameIndex(0)); // hello.txt
    var_dump($zip->getNameIndex(1)); // word.txt
    var_dump($zip->getNameIndex(2)); // ooxx.jpg
} else {
    echo 'failed, code:' . $res;
}
$zip->close();
?>

根据压缩内的文件名称，获取该文件的文本流
ZipArchive::getStream
resource ZipArchive::getStream ( string $name )
<?php
$zip = new ZipArchive();
$res = $zip->open('test.zip');
if ($res === TRUE) {
    $stream = $zip->getStream('hello.txt');
} else {
    echo 'failed, code:' . $res;
}
$zip->close();
$str = stream_get_contents($stream); //这里注意获取到的文本编码
var_dump($str);
?>

根据压缩文件内的索引（从0开始）修改压缩文件内的文件名
ZipArchive::renameIndex
bool ZipArchive::renameIndex ( int $index , string $newname )
(PHP 5 >= 5.2.0, PECL zip >= 1.5.0)
成功时返回 TRUE， 或者在失败时返回 FALSE。
<?php
$zip = new ZipArchive;
$res = $zip->open('test.zip');
if ($res === TRUE) {
    //把压缩文件内第一个文件修改成newname.txt
    $zip->renameIndex(0,'newname.txt');
    $zip->close();
} else {
    echo 'failed, code:' . $res;
}
?>

根据压缩文件内的文件名，修改压缩文件内的文件名
ZipArchive::renameName
(PHP 5 >= 5.2.0, PECL zip >= 1.5.0)
<?php
$zip = new ZipArchive;
$res = $zip->open('test.zip');
if ($res === TRUE) {
    //把压缩文件内的word.txt修改成newword.txt
    $zip->renameName('word.txt','newword.txt');
    $zip->close();
} else {
    echo 'failed, code:' . $res;
}
?>

获取压缩文件的注释（zip的文件注释）
ZipArchive::getArchiveComment
(PHP 5 >= 5.2.0, PECL zip >= 1.1.0)
string ZipArchive::getArchiveComment ([ int $flags ] )
参数：ZipArchive::FL_UNCHANGED
如果参数设置为 ZipArchive::FL_UNCHANGED, 返回原始的还没有改变的注释
例如，在处理该压缩文件时，使用setArchiveComment()方法改变或设置注释时
如果加上ZipArchive::FL_UNCHANGED这个参数，则表示获取改变之前的注释内容,否则获取已经改变的注释内容
类似的还有：
ZipArchive::getCommentIndex 根据压缩文件内的文件索引获取【文件注释】
ZipArchive::getCommentName    根据压缩文件内的文件名称获取【文件注释】
注意：这里的是文件注释，不是压缩文件（zip）的注释


设置或修改压缩文件的注释（zip的文件注释）
ZipArchive::setArchiveComment
(PHP 5 >= 5.2.0, PECL zip >= 1.4.0)
bool ZipArchive::setArchiveComment ( string $comment )
<?php
$zip = new ZipArchive;
$res = $zip->open('test.zip', ZipArchive::CREATE);
if ($res === TRUE) {
    //$zip->addFromString('test.txt', 'file content goes here');
    $zip->setArchiveComment('new archive comment');
    $zip->close();
    echo 'ok';
} else {
    echo 'failed';
}
?>

根据压缩文件内的索引删除压缩文件内的文件（也就是删除档案内的条目）
ZipArchive::deleteIndex
(PHP 5 >= 5.2.0, PECL zip >= 1.5.0)



一、如何解压缩一个zip文件 extractTo()

$zip = new ZipArchive();


一、如何创建压缩文件？ addFromString() addFile()
即是是把一个或多个文件打包成一个zip文件

1、只需要new一个ZipArchive对象
2、然后使用该对象的open方法创建一个zip文件
3、接着使用addFile方法，将要打包的文件写入刚刚创建的zip文件中
4、最后记得关闭该对象

<?php
//建立一个新的ZipArchive的对象
$zip = new ZipArchive;
$res = $zip->open('test.zip');
//如果打开成功
if ($res === TRUE) {

//如果打开失败
} else {
    //输出出错的代码
    echo 'failed, code:' . $res;
}
$zip->close();


--------------------- 查阅的相关文档 ---------------------

查阅的相关文档：

官方文档
http://www.php.net/manual/zh/book.zip.php

PHP ZipArchive 实现压缩解压Zip文件
http://www.yuansir-web.com/2011/08/31/php-ziparchive-%E5%AE%9E%E7%8E%B0%E5%8E%8B%E7%BC%A9%E8%A7%A3%E5%8E%8Bzip%E6%96%87%E4%BB%B6/

PHP 使用ZipArchive压缩文件并下载
http://courages.us/archives/176

PHP中ZipArchive压缩文件并下载打包好的文件介绍
http://www.php100.com/html/php/lei/2013/0905/5288.html