PHP Handbuch
Zurück |  | Weiter

# CLXXXVII. Zip File Functionen

# Einführung

Diese Extension ermöglicht den transparenten Lese- und Schreibzugriff auf ZIP-komprimierte Archive und die darin enthaltenen Dateien.

# Anforderungen

## PHP 4

Die mit PHP 4 ausgelieferte Version der Extension benötigt die ZZIPlib Bibliothek von Guido Draheim ab Version 0.10.6

## PHP 5.2.0 und später

Die Extension nutzt nun Funktionalität der zlib von Jean-loup Gailly und Mark Adler.

# Installation

## PHP 4

> Anmerkung: Zip support before PHP 4.1.0 is experimental.

Warnung
Because the PHP 4 zip extension is unmaintained we recommend that the PECL extension is used rather than the bundled one.

### Linux systems

In order to use these functions you must compile PHP with zip support by using the `--with-zip[=DIR]` configure option, where [DIR] is the prefix of the ZZIPlib library install.

### Windows

Windows users need to enable `php_zip.dll` inside of `php.ini` in order to use these functions.

## PHP 5.2.0 and later

### Linux systems

In order to use these functions you must compile PHP with zip support by using the `--enable-zip` configure option.

### Windows

Windows users need to enable `php_zip.dll` inside of `php.ini` in order to use these functions.

## Installation via PECL

Zusätzliche Informationen, wie neue Releases, Downloads Quelldateien, Maintainerinformation und ein CHANGELOG finden Sie hier: http://pecl.php.net/package/zip.

Sie können die DLL für diese PECL Erweiterung entweder von PHP Downloads oder von http://snaps.php.net/ herunterladen.

Für PHP 4 finden Sie die DLL im `extensions/` Verzeichnis der PHP Windows Binärdistribution.

# Laufzeit Konfiguration

Diese Erweiterung definiert keine Konfigurationseinstellungen in der `php.ini`.

# Resource Typen

Die Zip Extension benutzt zwei Resourcetypen, einen für Verzeichnisse innerhalb eines Zip-Archivs und einen für die eigentlichen Dateieinträge innerhalb des Archivs.

# Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

ZipArchive uses class constants. There is three types of constants, Flags (FL_) errors (ER_) or mode (no prefix).

`ZIPARCHIVE::CREATE` (integer)

  Create the archive if it does not exist.

`ZIPARCHIVE::OVERWRITE` (integer)

  Always start a new archive, this mode will overwrite the file if it already exists.

`ZIPARCHIVE::EXCL` (integer)

  Error if archive already exists.

`ZIPARCHIVE::CHECKCONS` (integer)

  Perform additional consistency checks on the archive, and error if they fail.

`ZIPARCHIVE::FL_NOCASE` (integer)

  Ignore case on name lookup

`ZIPARCHIVE::FL_NODIR` (integer)

  Ignore directory component

`ZIPARCHIVE::FL_COMPRESSED` (integer)

  Read compressed data

`ZIPARCHIVE::FL_UNCHANGED` (integer)

  Use original data, ignoring changes.

`ZIPARCHIVE::CM_DEFAULT` (integer)

  better of deflate or store.

`ZIPARCHIVE::CM_STORE` (integer)

  stored (uncompressed).

`ZIPARCHIVE::CM_SHRINK` (integer)

  shrunk

`ZIPARCHIVE::CM_REDUCE_1` (integer)

  reduced with factor 1

`ZIPARCHIVE::CM_REDUCE_2` (integer)

  reduced with factor 2

`ZIPARCHIVE::CM_REDUCE_3` (integer)

  reduced with factor 3

`ZIPARCHIVE::CM_REDUCE_4` (integer)

  reduced with factor 4

`ZIPARCHIVE::CM_IMPLODE` (integer)

  imploded

`ZIPARCHIVE::CM_DEFLATE` (integer)

  deflated

`ZIPARCHIVE::CM_DEFLATE64` (integer)

  deflate64

`ZIPARCHIVE::CM_PKWARE_IMPLODE` (integer)

  PKWARE imploding

`ZIPARCHIVE::CM_BZIP2` (integer)

  BZIP2 algorithm

`ZIPARCHIVE::ER_OK` (integer)

  No error.

`ZIPARCHIVE::ER_MULTIDISK` (integer)

  Multi-disk zip archives not supported.

`ZIPARCHIVE::ER_RENAME` (integer)

  Renaming temporary file failed.

`ZIPARCHIVE::ER_CLOSE` (integer)

  Closing zip archive failed

`ZIPARCHIVE::ER_SEEK` (integer)

  Seek error

`ZIPARCHIVE::ER_READ` (integer)

  Read error

`ZIPARCHIVE::ER_WRITE` (integer)

  Write error

`ZIPARCHIVE::ER_CRC` (integer)

  CRC error

`ZIPARCHIVE::ER_ZIPCLOSED` (integer)

  Containing zip archive was closed

`ZIPARCHIVE::ER_NOENT` (integer)

  No such file.

`ZIPARCHIVE::ER_EXISTS` (integer)

  File already exists

`ZIPARCHIVE::ER_OPEN` (integer)

  Can't open file

`ZIPARCHIVE::ER_TMPOPEN` (integer)

  Failure to create temporary file.

`ZIPARCHIVE::ER_ZLIB` (integer)

  Zlib error

`ZIPARCHIVE::ER_MEMORY` (integer)

  Memory allocation failure

`ZIPARCHIVE::ER_CHANGED` (string)

  Entry has been changed

`ZIPARCHIVE::ER_COMPNOTSUPP` (integer)

  Compression method not supported.

`ZIPARCHIVE::ER_EOF` (integer)

  Premature EOF

`ZIPARCHIVE::ER_INVAL` (integer)

  Invalid argument

`ZIPARCHIVE::ER_NOZIP` (integer)

  Not a zip archive

`ZIPARCHIVE::ER_INTERNAL` (integer)

  Internal error

`ZIPARCHIVE::ER_INCONS` (integer)

  Zip archive inconsistent

`ZIPARCHIVE::ER_REMOVE` (integer)

  Can't remove file

`ZIPARCHIVE::ER_DELETED` (integer)

  Entry has been deleted

# Beispiele

Beispiel 1. Erstellen eines Zip-Archivs

`<?php
$zip = new ZipArchive();
$filename = "./test112.zip";
if ($zip->open($filename, ZIPARCHIVE::CREATE)!==TRUE) {
exit("cannot open <$filename>\n");
}
$zip->addFromString("testfilephp.txt" . time(), "#1 This is a test string added as testfilephp.txt.\n");
$zip->addFromString("testfilephp2.txt" . time(), "#2 This is a test string added as testfilephp2.txt.\n");
$zip->addFile($thisdir . "/too.php","/testfromfile.php");
echo "numfiles: " . $zip->numFiles . "\n";
echo "status:" . $zip->status . "\n";
$zip->close();
?>`

Beispiel 2. Ausgabe eines detailierten Archivlistings

`<?php
$za = new ZipArchive();
$za->open('test_with_comment.zip');
print_r($za);
var_dump($za);
echo "numFiles: " . $za->numFiles . "\n";
echo "status: " . $za->status . "\n";
echo "statusSys: " . $za->statusSys . "\n";
echo "filename: " . $za->filename . "\n";
echo "comment: " . $za->comment . "\n";
for ($i=0; $i<$za->numFiles;$i++) {
echo "index: $i\n";
print_r($za->statIndex($i));
}
echo "numFile:" . $za->numFiles . "\n";
?>`

Beispiel 3. Zip Stream Wrapper, Auslesen von OpenOffice Metainformationen

`<?php
$reader = new XMLReader();
$reader->open('zip://' . dirname(__FILE__) . '/test.odt#meta.xml');
$odt_meta = array();
while ($reader->read()) {
if ($reader->nodeType == XMLREADER::ELEMENT) {
$elm = $reader->name;
} else {
if ($reader->nodeType == XMLREADER::END_ELEMENT && $reader->name == 'office:meta') {
break;
}
if (!trim($reader->value)) {
continue;
}
$odt_meta[$elm] = $reader->value;
}
}
print_r($odt_meta);
?>`

Das folgende Beispiel benutzt das alte PHP 4 API, es öffnet eine Zip-Datei, liest jede einzelne Datei im Archiv und gibt deren Inhalt aus. Die in diesem Beispiel genutzte `test2.zip` Datei ist Teil des Testarchivs des ZZIPlib Quellcodes.

Beispiel 4. Zip Beispiel

`<?php
$zip = zip_open("/tmp/test2.zip");
if ($zip) {
while ($zip_entry = zip_read($zip)) {
echo "Name: " . zip_entry_name($zip_entry) . "\n";
echo "Actual Filesize: " . zip_entry_filesize($zip_entry) . "\n";
echo "Compressed Size: " . zip_entry_compressedsize($zip_entry) . "\n";
echo "Compression Method: " . zip_entry_compressionmethod($zip_entry) . "\n";
if (zip_entry_open($zip, $zip_entry, "r")) {
echo "File Contents:\n";
$buf = zip_entry_read($zip_entry, zip_entry_filesize($zip_entry));
echo "$buf\n";
zip_entry_close($zip_entry);
}
echo "\n";
}
zip_close($zip);
}
?>`

Zurück | Zum Anfang | Weiter
yp_order | Nach oben | zip_close