VII. Bzip2

Introdução

As funções para bzip2 são usadas para ler e escrever, de forma transparente, arquivos compactados do tipo bzip2 (.bz2).

Dependências

Este módulo utiliza as funções da biblioteca bzip2 desenvolvida por Julian Seward

Instalação

O suporte às funções para Bzip2 no PHP não é habilitado por padrão. Você precisa usar a opção de configuração --with-bz2 quando for compilar o PHP para habilitar o suporte a bzip2. Este módulo requer bzip2/libbzip2, versão >= 1.0.x.

Configurações em execução

Esta extensão não define nenhum parâmetro de configuração no php.ini.

Tipos Resource

Esta extensão define um tipo de recurso (resource): um ponteiro para arquivo que identifica o arquivo bzip2 que está sendo usado.

Constantes pré-definidas

Esta extensão não possui nenhuma constante.

Exemplos

Este exemplo abre um arquivo temporário e escreve uma string de test nele, e então mostra o conteúdo do arquivo.

Exemplo 1. Um exemplo simples de bzip2

<?php

$arquivo
= "/tmp/testfile.bz2";
$str = "This is a test string.\n";

// abre o arquivo para escrita
$bz = bzopen($arquivo, "w");

// escreve a string no arquivo
bzwrite($bz, $str);

// fecha o arquivo
bzclose($bz);

// abre o arquivo para leitura
$bz = bzopen($arquivo, "r");

// lê 10 caracteres
echo bzread($bz, 10);

// imprime até o final do arquivo (ou os próximos 1024 caracteres)  
echo bzread($bz);

// fecha o arquivo
bzclose($bz);

?>
Índice
bzclose -- Fecha um ponteiro de arquivo bzip2
bzcompress -- Comprime uma string em dados no formato bzip2
bzdecompress -- Descomprime dados no formato bzip2
bzerrno -- Retorna um número de erro do bzip2
bzerror -- Retorna o número e string de erro do bzip2 como um array
bzerrstr -- Retorna a string de erro do bzip2
bzflush -- Força a escrita de todos os dados que estão no buffer
bzopen -- Abre um arquivo comprimido com bzip2
bzread -- Leitura binary-safe de um arquivo bzip2
bzwrite -- Escrita binary-safe em um arquivo bzip2