Komprimierungsfilter

Während die Komprimierungs-Wrapper die Möglichkeit bieten, auf dem lokalen Dateisystem gzip- und bz2-kompatible Dateien zu erstellen, können sie weder mit komprimierten Netzwerkprotokollen umgehen, noch bieten sie eine Möglichkeit, einen unkomprimierten Stream zu erstellen und ihn dann zu komprimieren. Im Gegensatz dazu können Komprimierungsfilter jederzeit auf alle Stream-Ressourcen angewendet werden.

Hinweis: Komprimierungsfilter erzeugen keine Kopfzeilen und Anhänge (Trailer), wie sie von Kommandozeilenprogrammen wie gzip verwendet werden. Sie komprimieren und dekomprimieren nur die eigentlichen Nutzdaten innerhalb des Streams.

zlib.deflate und zlib.inflate

zlib.deflate (Komprimierung) und zlib.inflate (Dekomprimierung) sind Implementierungen der in » RFC 1951 beschriebenen Komprimierungsmethoden. Der deflate-Filter benötigt bis zu drei Parameter, die als assoziatives Array übergeben werden. level gibt die Komprimierungsstufe an, die verwendet werden soll (1-9). Je höher die Zahl, desto kleiner wird im Allgemeinen die Größe der komprimierten Daten, aber umso länger wird auch die Verarbeitungszeit. Es gibt auch zwei spezielle Komprimierungsstufen: 0 (keine Komprimierung) und -1 (die zlib-interne Voreinstellung - derzeit 6). window ist der Logarithmus zur Basis 2 für die Größe des Loopback-Fensters (der Speicherpuffer). Höhere Werte (bis zu 15 -- 32768 Bytes) ergeben eine bessere Komprimierung auf Kosten des Speichers, während niedrigere Werte (bis zu 9 -- 512 Bytes) eine schlechtere Komprimierung bei geringerem Speicherbedarf ergeben. Der derzeitige Standardwert für window ist 15. memory gibt an, wieviel Arbeitsspeicher zugewiesen werden soll. Die gültigen Werte reichen von 1 (minimale Zuweisung) bis 9 (maximale Zuweisung). Diese Speicherzuweisung wirkt sich nur auf die Geschwindigkeit aus und hat keinen Einfluss auf die Größe der komprimierten Daten.

Hinweis: Da die Komprimierungsstufe der am häufigsten verwendete Parameter ist, kann er auch als einfacher Integer-Wert statt als Array-Element angegeben werden.

Die zlib.*-Komprimierungsfilter sind verfügbar wenn die zlib-Unterstützung aktiviert ist.

Beispiel #1 zlib.deflate und zlib.inflate

<?php
$params = array('level' => 6, 'window' => 15, 'memory' => 9);

$original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n";
echo "Der Originaltext ist " . strlen($original_text) . " Zeichen lang.\n";

$fp = fopen('test.deflated', 'w');
stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, $params);
fwrite($fp, $original_text);
fclose($fp);

echo "Die komprimierte Datei hat " . filesize('test.deflated') . " Bytes.\n";
echo "Der Originaltext war:\n";
/* Verwendung von readfile und zlib.inflate, um auf der Stelle zu dekomprimieren */
readfile('php://filter/zlib.inflate/resource=test.deflated');

/* Erzeugt die Ausgabe:

Der Originaltext ist 70 Zeichen lang.
Die komprimierte Datei hat 56 Bytes.
Der Originaltext war:
This is a test.
This is only a test.
This is not an important string.

 */
?>

Beispiel #2 Vereinfachte Verwendung von zlib.deflate

<?php
$original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n";
echo "Der Originaltext ist " . strlen($original_text) . " Zeichen lang.\n";

$fp = fopen('test.deflated', 'w');
/* Hier steht "6" für die Komprimierungsstufe 6 */
stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, 6);
fwrite($fp, $original_text);
fclose($fp);

echo "Die komprimierte Datei hat " . filesize('test.deflated') . " Bytes.\n";

/* Erzeugt die Ausgabe:

Der Originaltext ist 70 Zeichen lang.
Die komprimierte Datei hat 56 Bytes.

 */
?>

bzip2.compress und bzip2.decompress

bzip2.compress und bzip2.decompress funktionieren auf die gleiche Weise wie die oben beschriebenen zlib-Filter. Der Filter bzip2.compress akzeptiert bis zu zwei Parameter, die als Elemente eines assoziativen Arrays angegeben werden: blocks ist ein ganzzahliger Wert von 1 bis 9, der die Anzahl der 100kB-Speicherblöcke angibt, die dem Arbeitsbereich zugewiesen werden sollen. work ist ebenfalls ein ganzzahliger Wert. Er reicht von 0 bis 250 und gibt an, wie viel Aufwand mit der normalen Komprimierungsmethode betrieben werden soll, bevor auf eine langsamere, aber zuverlässigere Methode zurückgegriffen wird. Wenn dieser Wert geändert wird, wirkt sich das nur auf die Geschwindigkeit der Komprimierung aus. Weder die Größe der komprimierten Ausgabe noch der Speicherverbrauch werden durch diese Einstellung verändert. Ein Wert von 0 bedeutet, dass die Bibliothek ihre Standardkonfiguration verwenden soll. Der Filter bzip2.decompress akzeptiert nur einen Parameter, der entweder als gewöhnlicher boolescher Wert oder als Element small eines assoziativen Arrays übergeben werden kann. Wenn small auf true gesetzt ist, wird die bzip-Bibliothek angewiesen, die Dekomprimierung auf Kosten der Geschwindigkeit mit minimalem Speicherplatzbedarf durchzuführen.

Die bzip2.*-Komprimierungsfilter sind verfügbar wenn die bz2-Unterstützung aktiviert ist.

Beispiel #3 bzip2.compress und bzip2.decompress

<?php
$param = array('blocks' => 9, 'work' => 0);

echo "Die Originaldatei hat " . filesize('LICENSE') . " Bytes.";

$fp = fopen('LICENSE.compressed', 'w');
stream_filter_append($fp, 'bzip2.compress', STREAM_FILTER_WRITE, $param);
fwrite($fp, file_get_contents('LICENSE'));
fclose($fp);

echo "Die komprimierte Datei hat " . filesize('LICENSE.compressed') . " Bytes.\n";

/* Erzeugt die Ausgabe:

Die Originaldatei hat 3288 Bytes.
Die komprimierte Datei hat 1488 Bytes.

 */
?>