bzcompress
PHP Manual
PHP Manual»Funciones de Bzip2»bzcompress

bzcompress

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

bzcompress — Comprime una cadena con bzip2

Descripción

function bzcompress(string $data, int $block_size = 4, int $work_factor = 0): string|int

bzcompress() comprime la cadena dada y devuelve los datos así codificados.

Parámetros

data

La cadena a comprimir.

block_size

Especifica el tamaño de bloque utilizado durante la compresión y debe ser un número de 1 a 9, siendo 9 la mejor compresión, pero que utiliza más recursos para realizarse.

work_factor

Controla el comportamiento de la compresión en los peores casos de datos altamente repetitivos. Este valor puede ir de 0 a 250 (0 es un valor especial).

Independientemente del valor de work_factor, el resultado generado es el mismo.

Valores devueltos

La cadena comprimida o un número de error si ocurre un error.

Errores/Excepciones

A partir de PHP 8.5.0, se lanza una ValueError si block_size no está entre 1 y 9, o si work_factor no está entre 0 y 250.

Historial de cambios

Versión Descripción
8.5.0 Ahora se lanza una ValueError si block_size no está entre 1 y 9, o si work_factor no está entre 0 y 250.

Ejemplos

Ejemplo #1 Compresión de datos

<?php
$str = "datos de ejemplo";
$bzstr = bzcompress($str, 9);
echo $bzstr;
?>

Véase también

To Top