PharData::compressFiles

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Véase también#

Comprime todos los ficheros del archivo tar/zip actual

Descripción#

public PharData::compressFiles(int $compression): void
```php

Para los archivos basados en tar, este método genera una excepción `BadMethodCallException` ya que la compresión individual de los ficheros de un archivo tar no es soportada por este formato de archivo. Utilice `PharData::compress` para comprimir un archivo basado en tar completo.

Para los archivos basados en Zip, este método comprime todos los ficheros del archivo utilizando la compresión especificada. Las extensiones [zlib](#ref.zlib) o [bzip2](#ref.bzip2) deben estar activadas para aprovechar esta funcionalidad. Además, si al menos un fichero ya está comprimido utilizando la compresión bzip2/zlib, la extensión adecuada debe estar activada para descomprimir los ficheros antes de volver a comprimirlos.

## Parámetros

`compression`  
La compresión debe ser `Phar::GZ` o `Phar::BZ2` para aplicar una compresión, o `Phar::NONE` para eliminarla.

## Valores devueltos

No se retorna ningún valor.

## Errores/Excepciones

Genera una excepción `BadMethodCallException` si la variable INI [phar.readonly](#ini.phar.readonly) está a on, si la extensión [zlib](#ref.zlib) no está disponible o si al menos un fichero está comprimido vía bzip2 y la extensión [bzip2](#ref.bzip2) no está activada.

## Ejemplos

Un ejemplo con `PharData::compressFiles`

getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressed(Phar::BZ2)); var_dump($file->isCompressed(Phar::GZ)); } $p->compressFiles(Phar::GZ); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressed(Phar::BZ2)); var_dump($file->isCompressed(Phar::GZ)); } ?>

```php

El ejemplo anterior mostrará:

string(14) "monfichero.txt"
bool(false)
bool(false)
bool(false)
string(15) "monfichero2.txt"
bool(false)
bool(false)
bool(false)
string(14) "monfichero.txt"
int(4096)
bool(false)
bool(true)
string(15) "monfichero2.txt"
int(4096)
bool(false)
bool(true)

Véase también#

PharFileInfo::getCompressedSize, PharFileInfo::isCompressed, PharFileInfo::compress, PharFileInfo::decompress, Phar::canCompress, Phar::isCompressed, PharData::decompressFiles, Phar::getSupportedCompression, PharData::compress, PharData::decompress