PharData::compress

public PharData::compress(int $compression, [string $extension]): PharData
```php

Para los archivos tar, este método comprime el archivo completo utilizando la compresión gzip o bzip2. El archivo resultante puede ser manipulado con el comando gunzip/bunzip, o ser accedido directamente y de forma transparente con la extensión Phar.

Para los archivos zip, este método falla al lanzar una excepción. La extensión [zlib](#ref.zlib) debe estar activada para comprimir con gzip, la extensión [bzip2](#ref.bzip2) debe estar activada para comprimir con bzip2.

Asimismo, este método renombra automáticamente el archivo, añadiendo el sufijo `.gz`, `.bz2` o eliminando la extensión si `Phar::NONE` es especificado para eliminar la compresión. De lo contrario, una extensión de archivo puede ser especificada con el segundo argumento.

## Parámetros

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

`extension`  
Por omisión, la extensión es `.tar.gz` o `.tar.bz2` para comprimir un tar, y `.tar` para descomprimir.

## Valores devueltos

Un objeto `PharData` es devuelto en caso de éxito, `null` en caso de error.

## Errores/Excepciones

Levanta una excepción `BadMethodCallException` si la extensión [zlib](#ref.zlib) no está disponible, o si la extensión [bzip2](#ref.bzip2) no está activada.

## Historial de cambios

| Versión | Descripción                    |
|---------|--------------------------------|
| 8.0.0   | `extension` ahora es nullable. |

## Ejemplos

Un ejemplo con `PharData::compress`