Phar::compressAllFilesBZIP2

Compresses all files in the current Phar archive using Bzip2 compression

Beschreibung

public bool Phar::compressAllFilesBZIP2 ( void )

Hinweis:
Diese Methode wurde beginnend mit Version 2.0.0 der phar-Extension entfernt. Alternative Implementationen bieten Phar::compress, Phar::decompress, Phar::compressFiles und Phar::decompressFiles.

Hinweis:
Diese Methode des Phar-Objekts funktioniert nur wenn die php.ini-Einstellung phar.readonly auf 0 gesetzt ist, sonst wird eine PharException geworfen.

This method compresses all files in the Phar archive using bzip2 compression. The bzip2 extension must be enabled to take advantage of this feature. In addition, if any files are already compressed using gzip compression, the zlib extension must be enabled in order to decompress the files prior to re-compressing with bzip2 compression. As with all functionality that modifies the contents of a phar, the phar.readonly INI variable must be off in order to succeed.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Fehler/Exceptions

Throws BadMethodCallException if the phar.readonly INI variable is on, the bzip2 extension is not available, or if any files are compressed using gzip compression and the zlib extension is not enabled.

Beispiele

Beispiel #1 A Phar::compressAllFilesBZIP2 example


<?php
$p = new Phar('/path/to/my.phar', 0, 'my.phar');
$p['myfile.txt'] = 'hi';
$p['myfile2.txt'] = 'hi';
foreach ($p as $file) {
    var_dump($file->getFileName());
    var_dump($file->isCompressed());
    var_dump($file->isCompressedBZIP2());
    var_dump($file->isCompressedGZ());
}
$p->compressAllFilesBZIP2();
foreach ($p as $file) {
    var_dump($file->getFileName());
    var_dump($file->isCompressed());
    var_dump($file->isCompressedBZIP2());
    var_dump($file->isCompressedGZ());
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

string(10) "myfile.txt"
bool(false)
bool(false)
bool(false)
string(11) "myfile2.txt"
bool(false)
bool(false)
bool(false)
string(10) "myfile.txt"
bool(true)
bool(true)
bool(false)
string(11) "myfile2.txt"
bool(true)
bool(true)
bool(false)

Siehe auch

PharFileInfo::getCompressedSize
PharFileInfo::isCompressedBZIP2
PharFileInfo::isCompressed
PharFileInfo::isCompressedGZ
PharFileInfo::setCompressedBZIP2
PharFileInfo::setUncompressed
PharFileInfo::setCompressedGZ
Phar::canCompress
Phar::isCompressed
Phar::compressAllFilesGZ
Phar::getSupportedCompression
Phar::uncompressAllFiles