PclZip介绍
PclZip library可以压缩与解压缩Zip格式的压缩档（WinZip、PKZIP）；且能对此类类档案进行处理，包括产生压缩档、列出压缩档的内容以及解压缩档案等等。因为可以在伺服器端进行压缩与解压缩的动做，因此至关方便使用。
PclZip定义一个PclZip类别，其类别物件可视为一个ZIP档案，亦提供method来进行处理。php
如何使用PclZip
1.基础
全部的功能都由pclzip.lib.php这个档案提供，PclZip library可于其首页(www.phpconcept.net/pclzip/index.en.php)下载。全部的PKZIP档案其实就是一个PclZip的类别物件。当产生一个PclZip档案（ie, PclZip类别物件），就会先产生一个压缩档，且档名已经指定，但此压缩档的内容还没有存在：html
| < ?PHP |
| require_once('pclzip.lib.php'); |
| $archive = new PclZip("archive.zip"); |
| ?> |
此物件提供了一些public method可用来处理此档案。
2.参数
每个method有其各自可以使用的参数，包括有必须与非必须的参数：post
| < ?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或是阵列。ui
4.错误处理
从版本1.3以后，错误处理已经整合至PclZip类别中，当一个method回传错误码，能够得知一些额外的讯息以方便错误处理：
* errorName()：回传错误名称
* errorCode()：回传错误码
* errorInfo()：回传错误的描述spa
接下来会举几个例子来讲明如何使用PclZip。.net
PclZip实例一、产生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)。htm
下面的示例说明如何产生PKZIP压缩档(档名为archive.zip)，并将file.txt、data/text.txt以及目录folder(包含当中的档案与子目录)加入刚刚产生的archive.zip中：ip
| < ?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实例二、列出压缩档内容
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] = okget
PclZip实例三、解压缩档案
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