PharFileInfo::setCompressedGZ

(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 1.0.0)

PharFileInfo::setCompressedGZ — Comprimir la entrada actual de un Phar dentro del phar usando la compresión gz

Descripción

public PharFileInfo::setCompressedGZ ( void ) : bool

Nota:
Este método ha sido eliminado de la extensión Phar a partir de la versión 2.0.0. Implementaciones alternativas están disponibles utilizando PharFileInfo::isCompressed(), PharFileInfo::decompress(), y PharFileInfo::compress().

Este método comprime el fichero dentro del archivo Phar usando la compresión gzip. La extensión zlib debe estar habilitada para aprovechar esta característica. Además, si el fichero ya está comprimido con la compresión bzip2 , la extensión bzip2 debe estar habilitada para poder descomprimir el fichero. Al igual que con toda la funcionalidad que modifica el contenido de un Phar, la variable INI phar.readonly debe estar desactivada para poder realizar esto.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Errores/Excepciones

Lanza una excepción de tipo BadMethodCallException si la variable INI phar.readonly está activada, la extensión zlib no está disponible.

Ejemplos

Ejemplo #1 Un ejemplo de PharFileInfo::setCompressedGZ()


<?php
try {
    $p = new Phar('/ruta/a/mi.phar', 0, 'mi.phar');
    $p['mifichero.txt'] = 'hi';
    $fichero = $p['mifichero.txt'];
    var_dump($fichero->isCompressedGZ());
    $p['mifichero.txt']->setCompressedGZ();
    var_dump($fichero->isCompressedGZ());
} catch (Exception $e) {
    echo 'La operación de creación/modificación sobre mi.phar falló: ', $e;
}
?>

El resultado del ejemplo sería:

bool(false)
bool(true)

Ver también

PharFileInfo::getCompressedSize() - Devolver el tamaño real de un fichero (con compresión) dentro de un archivo Phar
PharFileInfo::isCompressedBZIP2() - Devolver si la entrada está comprimida con bzip2
PharFileInfo::isCompressed() - Devolver si la entrada está comprimida
PharFileInfo::isCompressedGZ() - Devolver si la entrada está comprimida con gz
PharFileInfo::setCompressedBZIP2() - Comprimir la entrada actual de un Phar dentro del phar usando la compresión Bzip2
PharFileInfo::setUncompressed() - Descomprimir la entrada actual del Phar dentro del phar, si está comprimida
Phar::canCompress() - Devuelve si la extensión phar soporta la compresión usando zlib o bzip2
Phar::isCompressed() - Devuelve Phar::GZ oPHAR::BZ2 si el archivo phar entero está comprimido (.tar.gz/tar.bz, etc.)
Phar::compressAllFilesBZIP2() - Comprimir todos los ficheros del archivo Phar actual usando la compresión Bzip2
Phar::compressAllFilesGZ() - Comprimir todos los ficheros del archivo Phar actual usando la compresión Gzip
Phar::getSupportedCompression() - Devolver un array de los algoritmos de compresión soportados
Phar::uncompressAllFiles() - Descomprimir todos los ficheros del archivo Phar actual