PharData::decompress

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

PharData::decompress — Descompacta todo o arquivo Phar

Descrição

public PharData::decompress(?string $extension = null): ?PharData

Para arquivos baseados em tar, esse método descompacta o arquivo inteiro.

Para arquivos Zip, este método falha com uma exceção. A extensão zlib deve ser habilitada para descompactar um arquivo compactado com gzip, e a bzip2 deve ser habilitada para descompactar um arquivo compactado com bzip2.

Além disso, este método renomeia automaticamente a extensão do arquivo compactado, .tar por padrão. Como alternativa, uma extensão de arquivo pode ser especificada com o parâmetro extension.

Parâmetros

extension: Para descompactação, a extensão de arquivo padrão é .tar. Use este parâmetro para especificar outra extensão de arquivo. Esteja ciente de que apenas arquivos executáveis podem conter .phar em seus nomes.

Valor Retornado

Um objeto PharData é retornado em caso de sucesso, ou null em caso de falha.

Erros/Exceções

Lança BadMethodCallException se a extensão zlib não estiver disponível ou se a extensão bzip2 não estiver habilitada.

Registro de Alterações

Versão	Descrição
8.0.0	`extension` agora é anulável.

Exemplos

Exemplo #1 Um exemplo de PharData::decompress()

<?php
$p = new PharData('/caminho/para/meu.tar.gz');
$p->decompress(); // cria /caminho/para/meu.tar
?>

Veja Também

PharFileInfo::getCompressedSize() - Retorna o tamanho real do arquivo (com compactação) dentro do arquivo Phar
PharFileInfo::isCompressed() - Informa se a entrada está compactada
PharFileInfo::compress() - Compacta a entrada Phar atual com zlib ou bzip2
PharFileInfo::decompress() - Descompacta a entrada Phar atual dentro do phar
PharData::compress() - Compacta todo o arquivo tar/zip usando Gzip ou Bzip2
Phar::canCompress() - Retorna se a extensão phar suporta compactação usando zlib ou bzip2
Phar::isCompressed() - Retorna Phar::GZ ou PHAR::BZ2 se todo o arquivo phar estiver compactado (.tar.gz/tar.bz e assim por diante)
PharData::compress() - Compacta todo o arquivo tar/zip usando Gzip ou Bzip2
Phar::getSupportedCompression() - Retorna um array de algoritmos de compactação suportados
PharData::compressFiles() - Compacta todos os arquivos no arquivo tar/zip atual
PharData::decompressFiles() - Descompacta todos os arquivos no arquivo zip atual

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicionar nota

Notas de Usuários 1 note

down

pttlens at gmail dot com ¶

6 years ago

If filename contains multiple dots(.), you can preserve other parts by following code (example1).Example #1 (Expected)<?php$filename = "abc.xyz.tar.gz";$p = new PharData($filename);$exts = explode('.', $filename);array_shift($exts);array_pop($exts);$ext = implode('.', $exts);$p->decompress($ext); # result filename: abc.xyz.tar?>Example #2 (might be unexpected)<?php$filename = "abc.xyz.tar.gz";$p = new PharData($filename);$p->decompress($filename); # result filename: abc.tar; xyz is truncated accidentally.?>

＋adicionar nota