PharData::decompress
(PHP >= 5.3.0, PECL phar >= 2.0.0)
PharData::decompress — Descomprimir un archivo Phar entero
Descripción
$extension
] )Para archivos phar basados en tar, este método descomprime el archivo entero.
Para archivos phar basados en Zip, este método este método falla con el lanzamiento de una excepción. La extensión zlib debe estar habilitada para descomprimir un archivo comprimido con la compresión gzip, y la extensión bzip2 debe estar habilitada para descomprimir un archivo comprimido con la compresión bzip2.
Además, este método renombra automáticamente la extensión de fichero del archivo, .tar por omisión. De forma alternativa, se puede expecificar una extensión de fichero con el segundo parámetro.
Parámetros
-
extension -
Para la descompresión, las extensión de fichero predeterminada es .phar.tar. Use este parámetro para especificar otra extensión de fichero. Observe que todos los archivos no ejecutables no pueden contener .phar en su nombre de fichero.
Valores devueltos
Devuelve un objeto de la clase PharData.
Errores/Excepciones
Lanza una excepción de tipo BadMethodCallException si la extensión zlib no está disponible, o la extensión bzip2 no está habilitada.
Ejemplos
Ejemplo #1 Un ejemplo de PharData::decompress()
<?php
$p = new PharData('/ruta/a/mi.phar', 0, 'mi.phar.gz');
$p['mifichero1.txt'] = 'hola';
$p['mifichero12.txt'] = 'hola';
$p3 = $p2->decompress(); // crea /ruta/a/mi.phar
?>
Ver también
- PharFileInfo::getCompressedSize() - Devolver el tamaño real de un fichero (con compresión) dentro de un archivo Phar
- PharFileInfo::isCompressed() - Devolver si la entrada está comprimida
- PharFileInfo::compress() - Comprimir la entrada del Phar actual con la compresión zlib o bzip2
- PharFileInfo::decompress() - Descomprimir la entrada Phar actual dentro del phar
- PharData::compress() - Comprimir el archivo tar/zip entero usando la compresión Gzip o Bzip2
- 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.)
- PharData::compress() - Comprimir el archivo tar/zip entero usando la compresión Gzip o Bzip2
- Phar::getSupportedCompression() - Devolver un array de los algoritmos de compresión soportados
- PharData::compressFiles() - Comprime todos los ficheros del archivo tar/zip actual
- PharData::decompressFiles() - Descomprimir todos los ficheros del archivo zip actual