# bzcompress

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

bzcompress — 把一个字符串压缩成 bzip2 编码数据

### 说明

bzcompress ( string `$source` [, int `$blocksize` = 4 [, int `$workfactor` = 0 ]] ) : mixed

bzcompress() 压缩了指定的字符串并以 bzip2 编码返回数据。

### 参数

`source`

  待压缩的字符串。

`blocksize`

  指定压缩时使用的块大小，应该是一个 1-9 的数字。9 可以有最高的压缩比，但会使用更多的资源。

`workfactor`

  控制压缩阶段出现最坏的重复性高的情况下输入数据时的行为。 该值可以是在 0 至 250 之间，0是一个特殊的情况。

  无论 `workfactor`是什么，产生的输出都是一致的。

### 返回值

压缩后的字符串，或者在出现错误时返回错误号。

### 范例

Example #1 压缩数据

    <?php
    $str = "sample data";
    $bzstr = bzcompress($str, 9);
    echo $bzstr;
    ?>

### 参见

- bzdecompress() - 解压经 bzip2 编码过的数据