php类PclZip简介与使用

PclZip介绍
PclZip library能够压缩与解压缩Zip格式的压缩档（WinZip、PKZIP）；且能对此类类档案进行处理，包括产生压缩档、列出压缩档的内容以及解压缩档案等等。由于能够在伺服器端进行压缩与解压缩的动作，所以相当方便使用。
PclZip定义一个PclZip类别，其类别物件可视为一个ZIP档案，亦提供method来进行处理。

如何使用PclZip
1.基础
所有的功能都由pclzip.lib.php这个档案提供，PclZip library可于其首页(www.phpconcept.net/pclzip/index.en.php)下载。所有的PKZIP档案其实就是一个PclZip的类别物件。当产生一个PclZip档案（ie, PclZip类别物件），就会先产生一个压缩档，且档名已经指定，但此压缩档的内容尚未存在：

< ?PHP
         require_once(‘pclzip.lib.php‘);
         $archive = new PclZip("archive.zip");
?>

此物件提供了一些public method可用来处理此档案。

2.参数
每一个method有其各自可使用的参数，包括有必须与非必须的参数：

< ?PHP
         require_once(‘pclzip.lib.php‘);
         $archive = new PclZip(‘archive.zip‘);
 
         $v_list = $archive->add(‘dev/file.txt‘,
                                    PCLZIP_OPT_REMOVE_PATH, ‘dev‘);
?>

上例中的‘dev/file.txt‘就是必须参数；‘PCLZIP_OPT_REMOVE_PATH‘则为非必须参数。当然有些method也可以只包含非必须的参数：

< ?PHP
         $list = $archive->extract(PCLZIP_OPT_PATH, "folder",
                          PCLZIP_OPT_REMOVE_PATH, "data",
                                PCLZIP_CB_PRE_EXTRACT, "callback_pre_extract",);
?>

上例中原本压缩档内档案存放的路径为/data，不过你可以指定解压缩至/folder中。此外，在解压缩之前，会呼叫callback function（‘callback_pre_extract()‘），此function可让使用者在解压缩的过程中变更档案存放路径与档名，或是选择某些档案不解压缩。
所有可用的非必要参数可参考网址(www.phpconcept.net/pclzip/man/en/index.php)。

3.回传值
每个method所回传的值可能会不同，将会在每个method中说明。不过大部分的method回传0、error或是阵列。

4.错误处理
从版本1.3之后，错误处理已经整合至PclZip类别中，当一个method回传错误码，可以得知一些额外的讯息以方便错误处理：
* errorName()：回传错误名称
* errorCode()：回传错误码
* errorInfo()：回传错误的描述

接下来会举几个例子来说明如何使用PclZip。

PclZip实例1、产生ZIP压缩档
PclZip($zipname)：为PclZip constructor，$zipname为PKZIP压缩档的档名。
主要是产生一个PclZip物件，即一个PKZIP压缩档；但此时，只有压缩档产生出来，并做一些检查（例如是否有开启zlib extension...等），除此之外，并没有做其他动作。
create($filelist, [optional arguments list])：将参数$filelist指定的档案或目录（包含当中所有档案与子目录）加入上述所产生的压缩档中。
而非必要的参数则能够修改压缩档内的档案存放路径。
此method可用的参数可以参考网志(www.phpconcept.net/pclzip/man/en/index.php)。

下面的示例说明如何产生PKZIP压缩档(档名为archive.zip)，并将file.txt、data/text.txt以及目录folder(包含当中的档案与子目录)加入刚刚产生的archive.zip中：

< ?PHP
        include_once(‘pclzip.lib.php‘);
        $archive = new PclZip(‘archive.zip‘);
        $v_list = $archive->create(‘file.txt,data/text.txt,folder‘);
        if ($v_list == 0) {
            die("Error : ".$archive->errorInfo(true));
        }
?>

下面的示例说明基本上与上例一样产生archive.zip，但在将file.txt与text.txt压缩于其中时，将路径由data/改为install/ ；因此，在archive.zip中这两个档案的路径会是install/file.txt与install/text.txt

< ?PHP
        include_once(‘pclzip.lib.php‘);
        $archive = new PclZip(‘archive.zip‘);
        $v_list = $archive->create(‘data/file.txt,data/text.txt‘,
                                         PCLZIP_OPT_REMOVE_PATH, ‘data‘,
                                         PCLZIP_OPT_ADD_PATH, ‘install‘);
        if ($v_list == 0) {
            die("Error : ".$archive->errorInfo(true));
        }
?>

PclZip实例2、列出压缩档内容
listContent( ) ：列出压缩档中的内容，包括档案的属性与目录：

< ?PHP
        include_once(‘pclzip.lib.php‘);
        $zip = new PclZip("test.zip");
 
        if (($list = $zip->listContent()) == 0) {
        die("Error : ".$zip->errorInfo(true));
        }
 
        for ($i=0; $i<sizeof ($list); $i++) {
            for(reset($list[$i]); $key = key($list[$i]); next($list[$i])) {
                echo "File $i / [$key] = ".$list[$i][$key]."<br/>";
            }
            echo "<br/>";
        }
?></sizeof>

上例将会回传结果：
File 0 / [filename] = data/file1.txt
File 0 / [stored_filename] = data/file1.txt
File 0 / [size] = 53
File 0 / [compressed_size] = 36
File 0 / [mtime] = 1010440428
File 0 / [comment] =
File 0 / [folder] = 0
File 0 / [index] = 0
File 0 / [status] = ok

File 1 / [filename] = data/file2.txt
File 1 / [stored_filename] = data/file2.txt
File 1 / [size] = 54
File 1 / [compressed_size] = 53
File 1 / [mtime] = 1011197724
File 1 / [comment] =
File 1 / [folder] = 0
File 1 / [index] = 1
File 1 / [status] = ok

PclZip实例3、解压缩档案
extract([options list]) ：解压缩PKZIP中的档案或目录。
[options list]可用的参数可参考网址(www.phpconcept.net/pclzip/man/en/index.php)。这些参数能让使用者在解压缩的时候有更多的选项，譬如指定变更解压缩档案的路径、指定只解压缩某些档案或不解压缩某些档案或者是将档案解压缩成字串输出(可用于readme档)。

下例是一个简单的解压缩档案示例，将压缩档archive.zip内的档案解压缩至目前的目录：

< ?PHP
        require_once(‘pclzip.lib.php‘);
        $archive = new PclZip(‘archive.zip‘);
 
 
        if ($archive->extract() == 0) {
            die("Error : ".$archive->errorInfo(true));
        }
?>

下例是进阶的解压缩档案使用，archive.zip中所有档案都解压缩于data/中，而特别指明在install/release中的所有档案也直接丢于data/中，而非data/install/ release：

< ?PHP
        include(‘pclzip.lib.php‘);
        $archive = new PclZip(‘archive.zip‘);
        if ($archive->extract(PCLZIP_OPT_PATH, ‘data‘,
                  PCLZIP_OPT_REMOVE_PATH, ‘install/release‘) == 0) {
                                die("Error : ".$archive->errorInfo(true));
        }
?>

相关文档：
PclZip官方地址：http://www.phpconcept.net/pclzip/index.php
PclZip手册地址：http://www.phpconcept.net/pclzip/man/en/index.php
PEAR类创建ZIP档案文件：http://www.ccvita.com/10.html
PclZip简介与使用：http://www.ccvita.com/59.html
PclZip:强大的PHP压缩与解压缩zip类：http://www.ccvita.com/330.html

时间： 2024-10-13 16:45:26

php类PclZip简介与使用的相关文章

InputStreamReader 和 OutputStreamWriter类用法简介及演示

最近正好在学java,对文件流比较感兴趣,因为C的文件操作算是比较简单的,没想到java弄得很复杂啊! 现在说说下面这两个类! InputStreamReader 和 OutputStreamWriter类用法简介. 一.InputStreamReader类 InputStreamReader 将字节流转换为字符流.是字节流通向字符流的桥梁.如果不指定字符集编码,该解码过程将使用平台默认的字符编码,如:GBK. 构造方法: InputStreamReader isr = new InputStr

Uml学习-类图简介

类图(Class Diagram)简介  类图是面向对象分析(OOA,Object-Oriented Analysis)和面向对象设计(OOP,Object-Oriented Deisgn)思想的重要工具,是业务结构建模的重要工具. 需求中提到的各种业务概念,人物等,经过抽象后都可以视之为类.将某类东西归纳在一起,可以称为一个类,类有很多种提炼角度,需要根据系统的目标,业务的场景等,选取合适的角度对事物进行归纳. 类的识别: 1．  类的识别 将需求分析中遇到的人.物.概念识别为类,这是比较容易

USB DFU特定类请求简介

下面的Table 1和Table 2简单列举了DFU特定类请求和他们的参数 Table 1. DFU类请求 Request Request code Request description DFU_DETACH 0X00 请求设备离开DFU模式,进入应用程序 DFU_DNLOAD 0x01 请求Host主机端数据发送到设备端,将数据加载到设备内部Flash.这个过程包含擦除Flash命令的过程 DFU_UPLOAD 0x02 请求设备端的数据传输到主机端,将设备内部Flash相应的数据加载到Ho

UIKit框架各个类的简介

1.UIAcceleration: 被叫做加速事件的一个UIAcceleration类的实例是用来代表即时的三维加速数据.为了接收重力加速度,要注册一个应用应用程序作为一个共享UIAccelerater对象的委托对象(参考UIAcceleromete类). 2. UIAccelerater: UIAccelerater类可以让你的寄存器接收到从板载硬件上得到的加速相关数据.当设备移动时,它的硬件能够报告沿主线在三维空间中的线性加速度变化.你可以利用这些数据来检测器件的电流方向和该方向的瞬时变化.

一、常用类的简介

1.基本数据类型的对象包装类[掌握] 1>基本数据类型与其对应的对象包装类 byte Byte short Short int Integer long Long float Float double Double char Character boolean Boolean 包装类的作用: a.将基本数据类型转换为引用数据类型,创建对象 b.包装类中包含了每一种基本数据类型中属性,包括最大值,最小值等 注意: a.Byte.Short.Integer.Long.Float.Double这六种都

UML类图简介

UML(Unified Modeling Language),即统一建模语言或标准建模语言,始于OMG(Object Management Group,对象管理组织),是OOAD(Object Oriented Analysis Design,面向对象的分析与设计)高潮时期的产物.UML是一门统一的可视化建模语言,主要表现形式是图,自然就会有许多不同种类的图,下面先介绍一下类图. 类图是一种静态图,用于描述系统中所包含的类以及它们之间的关系,是面向对象系统的建模中最为常见的一种图.在UML类图中

python的类（简介，没什么内容）

参考: https://www.cnblogs.com/studyDetail/p/6446180.html (python的类) https://www.cnblogs.com/zunchang/p/7965685.html (面向过程和面向对象编程,推荐) http://xukaizijian.blog.163.com/blog/static/170433119201111894228877/ (python类的内置方法) 类的定义有点像以下的格式: class ClassName([Bas

iOS之NSArray类簇简介-（copy、mutableCopy导致程序crash）

1.前言 开发时常常用数组对数据进行处理,对NSMutableArray进行操作时经常导致程序崩溃,特研究一下NSArray的类簇!涉及__NSPlaceholderArray.__NSArray0.__NSSingleObjectArrayI.__NSArrayI.__NSArrayM相关类. 2.分析NSArray 2.1.创建不可变出租 NSArray *placeholder = [NSArray alloc]; NSArray *arr1 = [placeholder init]; N

stringstream类的简介和用法

一.简介 <sstream>类库定义了三种类:istringstream,ostringstream,stringstream.分别用来进行流的输入,流的输出,输入输出操作.在此演示stringstream的使用.**stringstream最大的特点是可以很方便的实现各种数据类型的转换,不需要像C语言中转换那么麻烦,而且转换非常安全.所以stringstream经常用于方便安全的类型转换. 二.用法 (1)数据的分割(string --> string) 1 #include<s